Sintomas comuns da plataforma local em Docker e as suas causas — arranque, autenticação, gateway, projetos — e como confirmar que tudo está sincronizado.
Antes de tudo
- Docker com Compose v2, ~6 GB de RAM livres e acesso a
registry.nosi.cvesonatype.nosi.cv. - O hostname resolve? O slug do workspace tem de estar no ficheiro
hosts(127.0.0.1 <slug>; no Windows,C:\Windows\System32\drivers\etc\hostscomo Administrador). Usa sempre o mesmo hostname no browser — se alternares entre ele elocalhost, os callbacks não batem certo e o login falha. - A ordem foi respeitada? Stack principal primeiro, com o registo dos clientes OAuth concluído, e só depois projetos, Process e Monitoring.
Confirmar que está sincronizado
Um HTTP 200 não chega — a prova real é o sync com o Access Management:
| Tipo | Linha que tem de aparecer nos logs |
|---|---|
| Backends Spring Boot | Resource synchronization completed |
| Frontends Next.js | Access Management sync completed |
docker logs <contentor> 2>&1 | grep -c 'synchronization completed\|sync completed'Sintoma → causa
| Sintoma | Causa |
|---|---|
Erro do nginx em / | Application Center em Created: a readiness não completou. Ver docker logs <slug>-access-management-ready. |
...-ready sai com 3 | Self-heal desligado. docker restart <slug>-access-management e repetir o up. |
| Backend autentica e falha o sync com 404 | O segredo não corresponde ao cliente: ou é CHANGE_ME_* (o projeto arrancou antes de o registo escrever o segredo), ou é de um cliente que já não existe. |
No client_credentials configured ... static-token mode | O segredo M2M não chegou ao contentor. |
set: illegal option - numa tarefa de init | Script montado com fins de linha CRLF. |
/gateway-api/<x> dá 404 ao arrancar | Cache de rotas do gateway, até ~2 min. Se persistir, o nome da rota não bate certo com o vipAddress no Eureka — ver rota e client ID. |
401 em /gateway-api/<x>/actuator/health | Actuator protegido — prova que a rota existe. |
authorization_request_not_found no login | Cookie Secure sobre HTTP. Põe ACCESS_MANAGEMENT_SESSION_COOKIE_SECURE=false. |
| Login redireciona para um IP de contentor | O nginx não propaga Host/X-Forwarded-Host na rota do Access Management. |
| Login das UIs da Process falha | ACCESS_MANAGEMENT_OAUTH_CLIENT_SECRET diferente entre .env e process/.env_process. |
| App sem CSS, imagens quebradas, código antigo | Imagem antiga do projeto. up -d --build — ver Projetos. |
Cannot find module '/app/server.js' | Layout standalone aninhado; o arranque é node app/server.js. |
| Trocar de app força novo login | NEXTAUTH_SECRET diferente entre frontends do mesmo host. |
down de um projeto apaga contentores da raiz | COMPOSE_PROJECT_NAME definido num env-file. Não o definas. |
| Grafana sem dados das aplicações | A telemetria está desligada por defeito — ver Stack Monitoring. |
HTTP
O workspace corre em HTTP simples. Passa ACCESS_MANAGEMENT_SESSION_COOKIE_SECURE a true assim que servires por HTTPS.
How is this guide?
Última atualização: