iGRPIGRP 3.0Documentation

Stack principal

igrp-compose.yaml — os serviços da plataforma iGRP, as tarefas de inicialização do Access Management, como arrancar e parar, URLs e verificação.

A stack principal é a camada partilhada da plataforma. Está sempre presente, arranca primeiro e dela dependem os projetos e as stacks Process e Monitoring.

Modo Keycloak (por defeito)Modo Autentika
Composeigrp-compose.yamligrp-autentika-compose.yaml
Ambiente.env.igrp-autentika.env

Serviços

Os contentores têm o prefixo do workspace (<slug>-).

ServiçoPapelURL
nginxReverse proxy — a única porta exposta (NGINX_HTTP_PORT, a partir de 2575)
database-postgresPostgreSQL partilhado por todos os serviços
iam-keycloakFornecedor de identidade (só no modo Keycloak)/auth
access-managementAutorização: utilizadores, perfis, permissões, clientes OAuth
application-centerPortal de administração e entrada nas aplicações/
gatewayAPI Gateway para as APIs Spring/gateway-api/<serviço>
eurekaRegisto de serviços usado pelo gateway/eureka
minioArmazenamento de ficheiros (S3)/minio
redisCache
pgadminAdministração do PostgreSQL/pgadmin

As credenciais de administração (Keycloak, pgAdmin, superadmin do Access Management) estão no .env.

Tarefas de inicialização

Além dos serviços, a stack corre tarefas one-shot que preparam a plataforma. Tudo o que vem a seguir depende delas.

TarefaO que faz
*-db-prepareCria as bases de dados que faltem antes de o serviço arrancar
access-management-sas-schemaCria as tabelas do Spring Authorization Server numa base de dados nova
access-management-readyEspera pelo Access Management e prova que o catálogo de permissões está semeado
access-management-oauth-clientsRegista os clientes OAuth e service accounts da plataforma e dos teus projetos, e escreve os segredos nos env-files. Idempotente
access-management-oauth-client-uri-syncReconcilia os callbacks de login das UIs da plataforma e dos teus frontends

O primeiro arranque reinicia o Access Management uma vez

Numa base de dados nova, o catálogo de permissões só fica completo ao segundo arranque. A tarefa -ready deteta esse estado e reinicia o Access Management sozinha — ver o defeito do primeiro arranque.

O Access Management é distroless (sem shell nem curl), por isso não tem healthcheck próprio: a prontidão é dada pela tarefa -ready. Os detalhes do registo de clientes estão em Registo de clientes OAuth.

Arrancar e parar

Serviços → Visão Geral → IGRP Stack → ▶ para arrancar, ■ para parar. Ao criar o workspace, o Studio já arranca esta stack se o Docker estiver a correr.

Verificar

Application Center responde
http://<slug>:<porta>/ mostra a página de login.
Tarefas concluídas
docker compose ps -a mostra as tarefas -sas-schema, -ready e -oauth-clients em Exited (0).
Login funciona
Entra com o superadmin definido no .env.

Se algo falhar, ver Resolução de problemas.

How is this guide?

Última atualização: