Conteinerização, Kubernetes, observabilidade e CI/CD para os microsserviços do Infnet Hub
quinta e última entrega do Projeto de Bloco: Engenharia de Softwares Escaláveis (DR5)
| Implantação e operação | Qualidade e referência | ||
|---|---|---|---|
| 01 | Sobre o Projeto | 08 | Testes |
| 02 | Arquitetura de implantação | 09 | Demonstração |
| 03 | Como Executar | 10 | Gestão de configuração e versionamento |
| 04 | Docker | 11 | Stack |
| 05 | Kubernetes | 12 | Estrutura do Projeto |
| 06 | Observabilidade | 13 | Relatório Técnico |
| 07 | CI/CD com GitHub Actions | 14 | Licença |
O Infnet Hub é uma plataforma educacional — feed, vagas, boletim por competência e notificações ao vivo — construída ao longo de cinco entregas:
flowchart LR
TP1["TP1<br/>monólito"] --> TP2["TP2<br/>PostgreSQL"] --> TP3["TP3<br/>microsserviços"] --> TP4["TP4<br/>eventos<br/>RabbitMQ"] --> TP5["TP5<br/>produção<br/>Kubernetes"]
style TP5 fill:#1e3a8a,stroke:#3b8ef5,color:#ffffff
Esta entrega leva o sistema para a operação: o mesmo código dos serviços roda num cluster Kubernetes com autoescalonamento, autocura e atualização sem interrupção; cada requisição pode ser seguida de ponta a ponta — inclusive através do RabbitMQ — em traces, logs e métricas ligados entre si; e um pipeline constrói, testa, publica e implanta cada commit.
| Novidade | O que é |
|---|---|
| ☸️ Kubernetes | Kustomize com overlays local e produção; HPA, PDB, sondas, NetworkPolicy, contêineres sem root |
| 🔭 Rastreamento distribuído | OpenTelemetry → Tempo; o traceparent atravessa gateway, serviços, caixa de saída e RabbitMQ |
| 📜 Agregação de logs | JSON (ECS) → Grafana Alloy → Loki, com o traceId em cada linha |
| 🚨 Alertas | Sete regras no Prometheus: serviço fora ou sem instâncias, erro, latência, mensagem morta, outbox parada, nó do broker |
| 🔁 CI/CD | GitHub Actions: testes, validação da configuração, imagens no GHCR, implantação num cluster e testes contra ele |
| 🧪 Testes | 250 automatizados + coleção HTTP de ponta a ponta + teste de carga k6 com limites |
Important
O que a entrega prova não é que o sistema sobe num cluster, mas que ele aguenta operar: sob 60 usuários simultâneos o cluster criou réplicas sozinho e respondeu 70.190 requisições sem nenhuma falha; durante uma atualização do gateway, nenhuma requisição se perdeu.
flowchart TB
NAV([navegador]) -->|21000| FE
NAV -->|21080| GW
NAV -->|21180| KC
NAV -->|21300| GF
subgraph K8S["cluster kind — namespace infnethub (3 nós)"]
FE[frontend ×2]
GW[gateway ×2–4<br/>HPA]
KC[keycloak]
GW --> CORE[backend ×1–3<br/>HPA]
GW --> BOL[boletim ×1]
GW --> NOT[notificacao ×2–5<br/>HPA]
CORE & BOL & NOT <--> MQ{{rabbitmq<br/>StatefulSet ×3}}
CORE --- PG1[(postgres)]
BOL --- PG2[(postgres-boletim)]
NOT --- PG3[(postgres-notificacao)]
subgraph OBS["observabilidade"]
AL[alloy] --> LK[(loki)]
AL --> TP[(tempo)]
TP -->|métricas dos spans| PR[(prometheus)]
GF[grafana]
end
CORE & BOL & NOT & GW -.spans OTLP.-> AL
PR -.coleta.-> CORE & BOL & NOT & GW & MQ
GF --- PR & LK & TP
end
style MQ fill:#ff6600,stroke:#b34700,color:#ffffff
style K8S fill:#326ce514,stroke:#326ce5,stroke-width:2px
O mesmo desenho roda também no Docker Compose (desenvolvimento), com TLS em todos os trechos e o Eureka como registro; no cluster, o registro é o próprio Kubernetes (Service + DNS + readiness), sem alterar as rotas do gateway.
Pré-requisitos: Docker Desktop, kubectl e kind (scoop install kind
no Windows, brew install kind no macOS).
./k8s/implantar.shCria um cluster kind de três nós, instala o metrics-server, constrói as imagens, carrega-as nos nós e aplica os manifestos, esperando cada componente ficar pronto (≈ 5 min na primeira vez).
| Para ver | Onde |
|---|---|
| 🖥️ Aplicação | localhost:21000 |
| 📊 Grafana — operação, serviços, logs e rastreamento | localhost:21300 (conta suporte.ti) |
| 🐇 Painel do RabbitMQ | localhost:21673 (infnethub / infnethub) |
| 🔑 Keycloak — login e contas | localhost:21180 |
kubectl -n infnethub get pods,hpa -o wide # o cluster
kind delete cluster --name infnethub # removerdocker compose up -dMesmas portas, dezenove contêineres, TLS entre todos. Compose e cluster não sobem juntos.
Tip
No Windows, rode os .sh pelo Bash do Git:
& "$env:USERPROFILE\scoop\apps\git\current\bin\bash.exe" ./k8s/implantar.sh
Note
Contas de demonstração, todas com a senha infnet: lucas.mendonca (aluno),
carlos.oliveira (professor), atendimento (secretaria) e suporte.ti (único papel que entra
no Grafana).
Seis imagens, cada uma em três estágios:
| Estágio | Faz | Por quê |
|---|---|---|
compilacao |
Maven + JDK 25; poms antes do código | a camada de dependências é reaproveitada entre commits |
camadas |
java -Djarmode=tools extract --layers |
o JAR vira quatro camadas; num deploy típico só a da aplicação (KB) muda |
final |
JRE 25 Alpine, usuário 10001 (grupo 0), rótulos OCI | nada roda como root; a imagem diz de qual commit veio |
O front-end (Next.js 16, saída standalone) roda como o usuário node. As mesmas imagens servem
ao Compose e ao Kubernetes — o que muda entre ambientes é configuração, nunca o artefato.
Manifestos em k8s/, montados com Kustomize:
k8s/base/ o sistema — igual em todo ambiente
k8s/overlays/local/ imagens locais, segredos de desenvolvimento, NodePort (kind)
k8s/overlays/producao/ imagens do GHCR, segredos fora do repositório, Ingress com TLS, JVM de produção
| Recurso | Uso |
|---|---|
| Deployment | serviços sem estado; RollingUpdate com maxUnavailable: 0; espalhados entre nós |
| StatefulSet | PostgreSQL ×3, RabbitMQ ×3 (cluster formado pelo ordinal do pod), Loki, Tempo |
| Sessão compartilhada | Redis com as sessões de login do gateway: qualquer réplica atende qualquer navegador, e reiniciar uma não desloga ninguém |
| HorizontalPodAutoscaler | gateway 2–4, core 1–3, notificação 2–5, por CPU (meta 70%) |
| PodDisruptionBudget | nunca o último pod do gateway, do front-end, da notificação; um nó do broker por vez |
| Sondas | startup (subida longa), readiness (inclui o banco), liveness (só o processo), com prazo de resposta de 3 e 5 s |
| NetworkPolicy | entrada negada por padrão; cada banco aceita só o seu serviço — verificado: o front-end não alcança o PostgreSQL |
| securityContext | sem root, sem escalada, raiz só leitura, sem capabilities, seccomp |
| ConfigMap / Secret | configuração no ambiente (12-factor); segredos gerados pelo overlay |
O código ganhou o perfil k8s (application-k8s.*): descoberta pelo cluster no lugar do
Eureka, saída graciosa, readiness com o banco e logs em JSON.
Os três pilares, e as ligações entre eles:
| Pilar | Caminho | No Grafana |
|---|---|---|
| Métricas | Actuator/Micrometer → Prometheus (descoberta de pods) | painéis operação e serviços: p50/p95/p99, erro, vazão, CPU, memória, filas |
| Logs | JSON (ECS) na saída padrão → Alloy → Loki | painel logs e rastreamento; filtro por serviço, nível, texto e traceId |
| Traces | OpenTelemetry (OTLP) → Alloy → Tempo | mapa de serviços, traces com erro, trace completo de cada requisição |
Um cadastro feito no cluster, como o Tempo o mostra (dezenove spans, quatro serviços):
0 ms api-gateway http post
14 ms infnethub-core http post /api/v1/usuarios
611 ms infnethub-core outbox publicar UsuarioCadastradoV1 ← o relay, meio segundo depois
623 ms infnethub-core infnethub.eventos/usuario.cadastrado send
670 ms boletim-service boletim.usuarios receive
686 ms notificacao-service notificacao.eventos receive
969 ms notificacao-service notificacao.aovivo.… receive ← fanout: réplica 1
980 ms notificacao-service notificacao.aovivo.… receive ← fanout: réplica 2
Tip
O trace só atravessa a caixa de saída porque o traceparent é gravado junto com o evento
e retomado pelo relay. Sem isso, a publicação apareceria como um trace novo, sem pai. E o gateway
devolve o identificador em toda resposta, no cabeçalho X-Trace-Id.
Alertas (infra/prometheus/regras.yml): ServicoForaDoAr, ServicoSemInstancias,
TaxaDeErroAlta, LatenciaAlta, MensagensMortas, CaixaDeSaidaParada, NoDoBrokerFora.
Com o boletim reduzido a zero réplicas (cenário 7 da demonstração), ServicoSemInstancias dispara
em cerca de um minuto:
Painel serviços durante o teste de carga escala: cerca de 400 req/s, nenhum erro 5xx e
onze instâncias no ar, depois que o HPA escalou o gateway, o core e a notificação.
Painel logs e rastreamento: volume de logs e avisos por serviço vindos do Loki, busca nos logs, mapa de serviços derivado dos traces e traces com erro.
Um trace no Tempo: uma curtida passa pelo gateway, pelo core, pela caixa de saída e pelo RabbitMQ até o serviço de notificação, e aparece como um trace só.
flowchart LR
P[push / PR] --> T[testes back-end<br/>Testcontainers + JaCoCo]
P --> F[front-end<br/>lint · tipos · build]
P --> C[configuração<br/>compose · kubeconform<br/>promtool · alloy · actionlint]
T & F & C --> I[6 imagens<br/>GHCR, tag = SHA]
I -->|main| D[CD: cluster kind<br/>implanta o commit]
D --> E[coleção HTTP<br/>ponta a ponta]
E --> K[carga k6<br/>limites p95 e erro]
I -->|tag v*| R[release com<br/>notas do CHANGELOG]
| Workflow | Quando | O que garante |
|---|---|---|
ci.yml |
push em main, develop, release/*, hotfix/*, tags e todo PR |
código testado, configuração válida, imagens construídas (publicadas só na main e nas tags) |
cd.yml |
CI verde na main |
as imagens daquele commit sobem num cluster, respondem a 107 requisições com asserções e aguentam carga |
Só ações oficiais (actions/*, docker/*); GITHUB_TOKEN com a menor permissão de cada job;
imagens identificadas pelo SHA do commit, imutáveis.
| Nível | O que prova | Onde | Volume |
|---|---|---|---|
| Unidade | regras de domínio, contratos, filtros, rastreamento | */src/test |
250 testes JUnit, somando os três níveis |
| Fatia | JPA, web, segurança | @DataJpaTest, @WebMvcTest |
incluídos nos 250 |
| Integração | PostgreSQL e RabbitMQ reais (Testcontainers): outbox, confirmação, DLQ, saga, trace pelo broker | *IntegracaoTest |
incluídos nos 250 |
| Ponta a ponta | o sistema montado, no Compose ou no cluster | testes/e2e.sh |
107 requisições |
| Carga | latência e erro sob concorrência | testes/carga/ (k6) |
2 perfis |
| Pós-implantação | cada commit da main, num cluster novo |
cd.yml |
a cada entrega |
./mvnw verify # testes + cobertura (target/site/jacoco)
./testes/e2e.sh # coleção HTTP contra o ambiente no ar
./testes/carga/rodar.sh escala # k6: até 60 usuários por 7 minutosMedido no cluster local, perfil escala:
| Versão | Requisições | Falhas | p50 | p95 | p99 | Réplicas no pico |
|---|---|---|---|---|---|---|
| 1.0.0 | 70.190 | 0 | 16 ms | 47 ms | 90 ms | gateway 4 · core 3 · notificação 5 (o máximo de cada HPA) |
| 1.0.1 | 64.705 | 0 | 20 ms | 135 ms | 495 ms | gateway 4 · core 3 · notificação 3, sem nenhum reinício |
Na 1.0.1 cada resposta do feed carrega as curtidas e os comentários de todos os posts, e por isso pesa mais: o p95 subiu. Na tela, o saldo é o contrário, porque abrir o feed passou de 17 requisições para uma.
./demo/producao.sh # lista os cenários
./demo/producao.sh 5 # roda um| # | Cenário | O que prova |
|---|---|---|
| 1 | A implantação | 21 pods em 3 nós, HPA e PDB configurados |
| 2 | Autocura | um pod removido é reposto; nenhuma requisição falha |
| 3 | Autoescalonamento | sob carga k6, o HPA cria réplicas e depois as remove |
| 4 | Atualização sem interrupção | rolling update com tráfego, e rollout undo |
| 5 | Rastreamento | uma requisição, quatro serviços, um trace — pelo X-Trace-Id |
| 6 | Logs agregados | os logs daquela requisição, de todos os pods |
| 7 | Alerta | serviço fora do ar detectado pelo Prometheus |
| 8 | Nó do broker cai | o cluster do RabbitMQ segue; o StatefulSet repõe o nó |
Os dez cenários de eventos do TP4 continuam em demo/cenarios.sh (Compose).
-
Git Flow:
mainguarda só o que foi lançado (cada versão com sua tag);developé a integração;feature/*efix/*saem dedevelope voltam por pull request;release/*prepara a versão e entra namainpor pull request, seguida da tag e do merge de volta emdevelop;hotfix/*sai damainpara correções urgentes. -
GitHub:
mainedevelopprotegidas, mudanças só por pull request com o modelo e o CI verde como condição para o merge; o CODEOWNERS marca o responsável como revisor. -
Commits convencionais (
feat:,fix:,ci:,docs:…) e versões semânticas em tagsv*— a tag dispara a release com as notas doCHANGELOG.md. -
Dependabot semanal para Maven, npm, imagens Docker e ações, com os PRs mirando a
develop. -
Configuração fora do código:
.envno Compose, ConfigMap/Secret no cluster; o overlay de produção lê os segredos de um arquivo não versionado.
| Camada | Tecnologias |
|---|---|
| Back-end | |
| Mensageria e dados | |
| Front-end | |
| Implantação | |
| Observabilidade | |
| CI/CD e testes |
Árvore de pastas
TP5-PB_producao/
├── contratos/ infnethub-core/ boletim-service/ notificacao-service/
├── api-gateway/ eureka-server/ frontend/ os serviços (Dockerfile em cada um)
│ └── …/observabilidade/ rastreamento pela caixa de saída, filtro de ruído, X-Trace-Id
├── k8s/
│ ├── kind.yaml · kind-ci.yaml o cluster local (3 nós) e o do CI
│ ├── base/ Deployments, StatefulSets, HPA, PDB, NetworkPolicy
│ │ └── observabilidade/ Prometheus, Grafana, Loki, Tempo, Alloy
│ ├── overlays/local · overlays/producao
│ ├── complementos/metrics-server
│ └── implantar.sh
├── infra/ configuração compartilhada (Keycloak, RabbitMQ,
│ ├── alloy/ loki/ tempo/ Prometheus, Grafana, certificados) + coletores
│ ├── prometheus/regras.yml alertas
│ └── grafana/paineis/ três painéis versionados em JSON
├── .github/workflows/ci.yml · cd.yml o pipeline
├── testes/e2e.sh · testes/carga/ ponta a ponta e carga (k6)
├── demo/producao.sh · demo/cenarios.sh demonstração do TP5 e do TP4
├── http/ coleção de 107 requisições
├── doc/RELATORIO_TP5-PB.md · doc/asyncapi.yaml
├── CHANGELOG.md
└── docker-compose.yml
A documentação completa — decisões, medições, armadilhas, roteiro da apresentação e a cobertura
de cada rúbrica — está em doc/RELATORIO_TP5-PB.md. Os padrões de
mensagem e a arquitetura de eventos estão no
relatório do TP4,
e a especificação dos canais em doc/asyncapi.yaml.
Licença de Código Visível — Somente Leitura. Todos os direitos reservados. Este repositório é source-available, não código aberto: é público para ser lido, estudado e avaliado. Copiar, clonar, executar, modificar ou redistribuir requer autorização escrita — peça por uma issue. O corpo docente pode executar o projeto no necessário à avaliação. Texto integral, integridade acadêmica e aviso de proteção de dados (LGPD) em LICENSE.
O repositório não contém dados pessoais reais; as contas e registros são fictícios. Os logs
agregados levam identificadores (traceId, id do usuário), nunca senha ou token, e o Loki os
descarta em sete dias.
Créditos: ilustrações 3D da página 404 — Vecteezy (licença).



