# AWS EC2 — referência de homologação

Este documento descreve o ambiente de referência para hospedar as plataformas do DragonZord Teste 06 na
AWS. O host de homologação é `3.18.191.22`. Nenhuma credencial deve ser versionada.

## 1. Topologia

```
Route 53
  └── CloudFront
        └── ALB
              └── EC2 (app)
                    ├── RDS PostgreSQL / MySQL
                    ├── ElastiCache Redis
                    ├── S3 (assets + backups)
                    ├── SES (e-mail)
                    └── CloudWatch (logs/métricas)
```

## 2. EC2

### 2.1 Dimensionamento inicial

| Perfil | Instância | Uso |
| --- | --- | --- |
| Staging leve | t3.medium | 2 vCPU / 4 GB |
| Produção pequena | t3.large | 2 vCPU / 8 GB |
| Produção média | c6i.xlarge | 4 vCPU / 8 GB |
| Worker / filas | c6i.large | 2 vCPU / 4 GB |

### 2.2 Sistema operacional

- Ubuntu 22.04/24.04 LTS ou Amazon Linux 2023.
- Docker Engine + Docker Compose para desenvolvimento e staging.
- Nginx como reverse proxy.
- CloudWatch Agent para logs e métricas.
- SSM Agent para acesso sem chave SSH.

### 2.3 Segurança

- Security Group: apenas 80/443 do ALB e 22 restrito ao bastion/SSM.
- IAM Role da instância com acesso mínimo a S3, SSM e CloudWatch.
- EBS criptografado.
- Patch automatizado e imagens base versionadas.
- Sem chaves longas da AWS no servidor.

## 3. RDS

- PostgreSQL para Medusa, Saleor, Spree, Sylius e Vendure.
- MySQL/MariaDB para Bagisto, WooCommerce, EverShop, PrestaShop e OpenCart.
- Multi-AZ em produção.
- Backups automáticos com retenção mínima de 7 dias.
- Parameter Group ajustado para conexões e cache.
- Subnet privada; acesso somente pelo Security Group da aplicação.

## 4. ElastiCache Redis

- Cache de sessão, catálogo, carrinho e filas.
- Cluster mode desativado para começar; réplica em produção.
- AUTH e TLS quando disponível.
- Monitorar hit rate, memória e evictions.

## 5. S3

- Buckets separados por ambiente: `dragonzord-ecommerce-staging-assets`, `dragonzord-ecommerce-prod-assets`.
- Versionamento e bloqueio de acesso público.
- Criptografia SSE-S3 ou SSE-KMS.
- CloudFront para entrega de mídia.
- Lifecycle para backups e arquivos antigos.

## 6. Deploy

### 6.1 Desenvolvimento

```bash
docker compose up -d
```

### 6.2 Staging/Produção

1. Build da imagem Docker.
2. Push para Amazon ECR.
3. Deploy em EC2 com Docker Compose ou ECS.
4. Executar migrações como job separado.
5. Rodar smoke tests.
6. Trocar a versão no ALB.

### 6.3 Rollback

- Reverter para a tag/imagem anterior.
- Restaurar snapshot RDS se a migração for destrutiva.
- Invalidar cache do CloudFront se necessário.

## 7. Observabilidade

- CloudWatch Logs: aplicação, Nginx, workers.
- Métricas: CPU, memória, disco, conexões RDS, filas Redis.
- Alarmes: 5xx, latência p95, disco > 80%, conexões > limite, fila acumulada.
- Health checks no ALB.

## 8. Custos

- EC2 e RDS são os maiores custos.
- Use Savings Plans/Reserved Instances para cargas estáveis.
- S3 e CloudFront são proporcionais ao tráfego.
- ElasitCache pode ser substituído por Redis gerenciado menor em staging.

## 9. Checklist de entrada em produção

- [ ] Domínio e certificado ACM ativos.
- [ ] DNS apontando para CloudFront/ALB.
- [ ] RDS Multi-AZ e backups testados.
- [ ] S3 privado com versionamento.
- [ ] Segredos no SSM/Secrets Manager.
- [ ] CloudWatch e alarmes configurados.
- [ ] WAF ativo.
- [ ] Teste de carga realizado.
- [ ] Plano de rollback documentado.