EN

Nº 11de 12Índice

Plataforma de microsserviços

Loja em microsserviços atrás de um gateway: Nginx balanceando réplicas do Spring Cloud Gateway, JWT validado no Auth com cache no Redis, Kafka com outbox e um pipeline reutilizável no GitHub Actions

Ano
2026
Status
EM CURSO
Papel
Gateway, cache, Nginx e CI/CD · grupo de 3
Stack
Java · Spring Cloud Gateway · Spring Boot · Nginx +11
plataforma-microsservicos
Plataforma de microsserviços — Documentação do grupo — a arquitetura: Nginx na frente de duas réplicas do gateway, Redis, Auth, Account, Exchange e o Kafka até o Notification
5 capturas

1 de 5

Plataforma de microsserviços — Documentação do grupo — a arquitetura: Nginx na frente de duas réplicas do gateway, Redis, Auth, Account, Exchange e o Kafka até o Notification

Documentação do grupo — a arquitetura: Nginx na frente de duas réplicas do gateway, Redis, Auth, Account, Exchange e o Kafka até o Notification

01O projeto

Projeto da disciplina Plataformas, Microsserviços e APIs do Insper (2026.2), num grupo de três: a plataforma de uma loja em que o usuário se cadastra, faz login e consulta câmbio. O Nginx é o único ponto exposto e balanceia réplicas de um gateway em Spring Cloud Gateway (WebFlux), que lê o JWT do cookie, valida o token chamando o Auth e repassa a identidade no header id-account — descartando o que o cliente tenha mandado nesse header. Atrás dele ficam Auth, Account (Spring Boot + PostgreSQL) e Exchange (Python/FastAPI); um quinto serviço, Notification, consome do Kafka o evento de conta criada que o Account grava num outbox transacional. Prometheus e Grafana, teste de carga com k6, varredura com Trivy e manifestos de Kubernetes para o AWS EKS completam a plataforma. Dos 73 commits do repositório principal, 35 são meus: o gateway, o cache no Redis, o Nginx e o pipeline de CI/CD. Auth, Account, mensageria e EKS são do Nicolas; Exchange, observabilidade, testes de carga e HPA, do Gabriel.

02O que foi feito

  1. Gateway meu, com 20 testes: só registro, login e logout ficam abertos; todo o resto exige o JWT, validado no Auth, e o header id-account é sempre reescrito pelo gateway — o serviço de trás nunca confia no que veio do cliente

  2. Cache do token no Redis, compartilhado pelas réplicas: chave = SHA-256 do JWT e TTL de no máximo 5 min, nunca além do exp; em 3.001 requisições autenticadas, 1 chamada ao Auth — e, com o Redis fora, o gateway segue validando sem cache

  3. Nginx como único ponto exposto, re-resolvendo o DNS a cada 10 s: uma réplica nova do gateway entra no balanceamento sem reload

  4. Um pipeline reutilizável no GitHub Actions, chamado por cada serviço: build e testes, Trivy no código e na imagem com portão para CVE crítica corrigível, e imagem multi-arch no GHCR e no ECR, entrando na AWS por OIDC, sem chave no GitHub; o deploy no EKS pelo CI ainda espera o cluster

  5. Do grupo: Kafka com outbox transacional, consumo idempotente, 3 retentativas e fila de mensagens mortas no Notification; Prometheus e Grafana; teste de carga com k6 e HPA ensaiado num cluster kind; o EKS testado com deploy manual e smoke test

03Decisões

Decisão 01

Pergunta: Por que guardar o hash do token, e não o token, no Redis?

Resposta: O cache existe para tirar o Auth do caminho de toda requisição, não para virar um segundo lugar de onde roubar sessão. Com a chave sendo o SHA-256 do JWT, quem ler o Redis não consegue reutilizar token nenhum; e como o TTL nunca passa do exp, um token vencido não continua valendo por causa do cache.

Decisão 02

Pergunta: Por que um pipeline reutilizável e não um por serviço?

Resposta: Uma correção no pipeline vale para todos os serviços de uma vez. Cada microsserviço só tem um arquivo pequeno que chama o workflow do repositório principal, e o portão de segurança — Trivy reprovando CVE crítica corrigível ou segredo exposto — é o mesmo para todos.

04Capturas

  • gateway.webp

    A página do gateway, a minha parte: rotas, autorização via Auth e o header id-account reescrito

  • cache.webp

    Cache do token no Redis: cache-aside com a chave no SHA-256 do JWT e TTL que nunca passa do exp

  • ci-cd.webp

    O pipeline reutilizável no GitHub Actions: build e testes, Trivy no código e na imagem, portão de segurança, push multi-arch e deploy no EKS

  • testes-gateway.webp

    mvn test no gateway: 31 testes passando — os 20 do commit original e 11 que o RBAC do Nicolas somou depois

1 de 5

Plataforma de microsserviços — Documentação do grupo — a arquitetura: Nginx na frente de duas réplicas do gateway, Redis, Auth, Account, Exchange e o Kafka até o Notification

Documentação do grupo — a arquitetura: Nginx na frente de duas réplicas do gateway, Redis, Auth, Account, Exchange e o Kafka até o Notification

05Stack

  • Java
  • Spring Cloud Gateway
  • Spring Boot
  • Nginx
  • Redis
  • PostgreSQL
  • Kafka
  • Python
  • Kubernetes
  • AWS EKS
  • GitHub Actions
  • Trivy
  • Prometheus
  • Grafana
  • k6
Próximo projeto →Nº 12

Firmware em C++ para ESP32 com tela touch: 8 mini-apps em LVGL e simulador SDL2 para desenvolver sem a placa