Deploy AWS ECS + API Gateway — ecosif-masterdata
Público-alvo: DevOps / SRE
Objetivo: Configurar o serviço ecosif-masterdata na AWS com ECS e uma única API Gateway. URL final: https://app.ecosif.com.br/ecosif-masterdata. Este documento não cobre criação de banco de dados.
1. Arquitetura e mapeamento na API Gateway
| Path (API Gateway) | Target | Descrição |
|---|---|---|
/ecosif-masterdata / /ecosif-masterdata/{proxy+} |
ECS ecosif-masterdata (ALB) | Dados mestres (empresas, filiais, planos de contas, etc.) |
2. Context path
Configurar context path /ecosif-masterdata:
- No
application.yml:server.servlet.context-path: /ecosif-masterdata - Ou variável:
SERVER_SERVLET_CONTEXT_PATH=/ecosif-masterdata
3. Variáveis de ambiente para ECS (ecosif-masterdata)
3.1 Servidor
| Variável | Obrigatória | Descrição | Valor em ECS |
|---|---|---|---|
ECOSIF_MASTERDATA_PORT |
Sim* | Porta HTTP do contentor | 8080 |
SERVER_SERVLET_CONTEXT_PATH |
Sim | Prefixo da aplicação | /ecosif-masterdata |
3.2 Banco de Dados (PostgreSQL)
| Variável | Obrigatória | Descrição | Exemplo |
|---|---|---|---|
POSTGRES_HOST |
Sim | Host do PostgreSQL | ecosif-db.xxxxx.us-east-1.rds.amazonaws.com |
POSTGRES_PORT |
Sim | Porta | 5432 |
POSTGRES_DB |
Sim | Nome do banco | ecosif |
POSTGRES_USER |
Sim | Usuário | ecosif_masterdata |
POSTGRES_PASSWORD |
Sim | Senha | (secret) |
3.3 JWT e CORS
| Variável | Obrigatória | Descrição | Valor para app.ecosif.com.br |
|---|---|---|---|
AUTH_TOKEN_SECRET |
Sim | Chave JWT (igual ao ecosif-auth) | (secret) |
TOKEN_EXPIRATION |
Sim | Vida do token (ms) | 86400000 |
ECOSIF_CORS |
Sim | Origens CORS | https://app.ecosif.com.br |
3.4 JPA / Hibernate / AWS S3 (se usar)
| Variável | Obrigatória | Descrição | Valor típico |
|---|---|---|---|
HIBERNATE_DDL_AUTO |
Sim* | DDL Hibernate | validate |
AWS_ACCESS_KEY_ID |
Conforme uso | AWS (S3, etc.) | — |
AWS_SECRET_ACCESS_KEY |
Conforme uso | AWS | — |
AWS_DEFAULT_REGION |
Conforme uso | Região | us-east-1 |
AWS_S3_BUCKET |
Conforme uso | Bucket (import, etc.) | — |
LOG_FORMAT |
Não | Logback | json |
4. ECS (task definition)
- Porta do contentor: 8080.
- Health check (ALB):
/ecosif-masterdata/actuator/health. - Secrets:
POSTGRES_PASSWORD,AUTH_TOKEN_SECRET(e credenciais AWS se necessário).
Para lista completa de variáveis e S3, ver operational.md.