Skip to content

README.md

Latest commit

 

History

History
95 lines (78 loc) · 3.07 KB

README.md

File metadata and controls

95 lines (78 loc) · 3.07 KB

Microservices Node.js com Pulumi

Um projeto completo de microserviços em Node.js com arquitetura moderna, orquestração via Pulumi e infraestrutura como código na AWS.

Arquitetura

  • app-orders: Serviço de pedidos que expõe uma API REST
  • app-invoices: Serviço de faturas que consome mensagens do broker
  • Kong: API Gateway para roteamento de requisições
  • RabbitMQ: Message Broker para comunicação entre serviços
  • Pulumi: Infraestrutura como código para provisionamento na AWS
  • Jaeger: Rastreamento distribuído (OTEL)
  • PostgreSQL: Banco de dados para persistência

Pré-requisitos

  • Node.js >= 22
  • Docker & Docker Compose
  • Pulumi CLI >= 3.0
  • Credenciais AWS configuradas
  • Yarn (opcional, mas recomendado)

Estrutura do Projeto

.
├── app-orders/                # Serviço de Pedidos
│   ├── src/
│   │   ├── http/              # Servidor Fastify
│   │   ├── db/                # Schema e migrations Drizzle
│   │   ├── broker/            # Integração RabbitMQ
│   │   └── tracer/            # OpenTelemetry
│   ├── Dockerfile
│   └── docker-compose.yml
│
├── app-invoices/              # Serviço de Faturas
│   ├── src/
│   │   ├── http/              # Servidor Fastify
│   │   ├── db/                # Schema e migrations Drizzle
│   │   └── broker/            # Consumidor RabbitMQ
│   ├── Dockerfile
│   └── docker-compose.yml
│
├── infra/                      # Infraestrutura Pulumi
│   ├── src/
│   │   ├── cluster.ts          # ECS Cluster
│   │   ├── load-balancer.ts    # ALB e NLB
│   │   ├── images/             # ECR e Docker Images
│   │   └── services/           # Serviços Fargate
│   └── index.ts
│
├── contracts/                  # Interfaces compartilhadas
│   └── messages/
│
├── docker/                     # Configurações Docker
│   └── kong/                   # Kong API Gateway
│
└── docker-compose.yml          # Orquestração local

Variáveis de Ambiente

app-orders (.env)

DATABASE_URL="postgresql://user:password@host:5432/orders"
BROKER_URL="amqp://admin:admin@localhost:5672"
OTEL_SERVICE_NAME="orders"
OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4318"

app-invoices (.env)

DATABASE_URL="postgresql://user:password@host:5433/invoices"
BROKER_URL="amqp://admin:admin@localhost:5672"
OTEL_SERVICE_NAME="invoices"
OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4318"

Observabilidade

O projeto inclui integração completa com OpenTelemetry:

  • Traces: Jaeger em http://localhost:16686
  • Métricas: Configuradas para Grafana Cloud
  • Instrumentações: HTTP, Fastify, PostgreSQL, AMQP

☁️ Infraestrutura AWS

  • ECS Fargate: Orquestração de containers
  • Application Load Balancer: Roteamento HTTP
  • Network Load Balancer: Roteamento TCP (AMQP)
  • ECR: Registro de imagens Docker
  • Security Groups: Controle de acesso