@gugananuvem/aws-local-simulator 1.0.35 → 1.0.39

package/src/services/vpc/README.md

@@ -0,0 +1,459 @@
+# VPC Service - Simulador de Virtual Private Cloud
+
+Simulador completo de AWS VPC com suporte a rotas, subnets, Internet Gateways, VPC Endpoints e VPC Gateways.
+
+## Características
+
+✅ **VPCs**: Criar, listar, deletar, modificar atributos
+✅ **Subnets**: Criar subnets por VPC com validação de CIDR  
+✅ **Route Tables**: Tabelas de rotas com múltiplas regras de roteamento
+✅ **Internet Gateways**: Criar e associar a VPCs
+✅ **VPC Endpoints**: S3, DynamoDB, Lambda, SQS, SNS
+✅ **NAT Gateways**: Gerenciar gateways para subnets privadas
+✅ **VPN**: VPN Gateways e Connections (futuro)
+✅ **Tags**: Suporte completo para tags em todos os recursos
+
+## Arquitetura
+
+```
+src/services/vpc/
+├── index.js              # Serviço principal (VPCService)
+├── server.js             # Servidor HTTP com rotas
+├── simulator.js          # Lógica de simulação VPCSimulator
+├── models/
+│   ├── vpc.js            # Modelo de VPC
+│   ├── subnet.js         # Modelo de Subnet
+│   ├── routeTable.js     # Modelo de RouteTable
+│   ├── internetGateway.js # Modelo de IGW
+│   ├── vpcEndpoint.js    # Modelo de VPC Endpoint
+│   └── vpcGateway.js     # Modelo de NAT/VPN Gateways
+└── utils/
+    └── validators.js     # Validadores de CIDR, etc
+```
+
+## Configuração
+
+### arquivo `aws-local-simulator.json`
+
+```json
+{
+  "services": {
+    "vpc": true
+  },
+  "vpc": {
+    "vpcs": [
+      {
+        "CidrBlock": "10.0.0.0/16",
+        "Tags": [
+          { "Key": "Name", "Value": "main-vpc" }
+        ],
+        "EnableDnsHostnames": true,
+        "EnableDnsSupport": true
+      }
+    ],
+    "subnets": [
+      {
+        "VpcId": "vpc-xxxxx",
+        "CidrBlock": "10.0.1.0/24",
+        "AvailabilityZone": "us-east-1a",
+        "Tags": [
+          { "Key": "Name", "Value": "public-subnet" }
+        ],
+        "MapPublicIpOnLaunch": true
+      }
+    ]
+  }
+}
+```
+
+### Variáveis de Ambiente
+
+```bash
+# Habilitar/Desabilitar
+export AWS_LOCAL_SIMULATOR_VPC=true
+
+# Porta (padrão: 4014)
+export AWS_LOCAL_SIMULATOR_VPC_PORT=4014
+```
+
+## API REST
+
+### VPCs
+
+#### Criar VPC
+```
+POST /__admin/vpcs/create
+Content-Type: application/json
+
+{
+  "CidrBlock": "10.0.0.0/16",
+  "Tags": [
+    { "Key": "Name", "Value": "my-vpc" }
+  ],
+  "EnableDnsHostnames": true,
+  "EnableDnsSupport": true
+}
+```
+
+#### Listar VPCs
+```
+GET /__admin/vpcs
+GET /__admin/vpcs?vpcIds=vpc-xxxxx
+```
+
+#### Obter VPC
+```
+GET /__admin/vpcs/{vpcId}
+```
+
+#### Modificar VPC
+```
+POST /__admin/vpcs/{vpcId}/attributes
+Content-Type: application/json
+
+{
+  "attribute": "enableDnsHostnames|enableDnsSupport",
+  "value": true/false
+}
+```
+
+#### Deletar VPC
+```
+DELETE /__admin/vpcs/{vpcId}
+```
+
+### Subnets
+
+#### Criar Subnet
+```
+POST /__admin/subnets/create
+Content-Type: application/json
+
+{
+  "VpcId": "vpc-xxxxx",
+  "CidrBlock": "10.0.1.0/24",
+  "AvailabilityZone": "us-east-1a",
+  "Tags": [],
+  "MapPublicIpOnLaunch": true
+}
+```
+
+#### Listar Subnets
+```
+GET /__admin/subnets
+GET /__admin/subnets?vpcIds=vpc-xxxxx
+```
+
+#### Obter Subnet
+```
+GET /__admin/subnets/{subnetId}
+```
+
+#### Deletar Subnet
+```
+DELETE /__admin/subnets/{subnetId}
+```
+
+### Route Tables
+
+#### Criar Route Table
+```
+POST /__admin/route-tables/create
+Content-Type: application/json
+
+{
+  "VpcId": "vpc-xxxxx",
+  "Tags": []
+}
+```
+
+#### Listar Route Tables
+```
+GET /__admin/route-tables
+GET /__admin/route-tables?vpcIds=vpc-xxxxx
+```
+
+#### Obter Route Table
+```
+GET /__admin/route-tables/{rtId}
+```
+
+#### Adicionar Rota
+```
+POST /__admin/route-tables/{rtId}/routes
+Content-Type: application/json
+
+{
+  "DestinationCidrBlock": "0.0.0.0/0",
+  "Target": "igw-xxxxx",
+  "TargetType": "igw|nat|vpce|instance"
+}
+```
+
+#### Remover Rota
+```
+DELETE /__admin/route-tables/{rtId}/routes/{cidr}
+```
+
+#### Associar com Subnet
+```
+POST /__admin/route-tables/{rtId}/associations
+Content-Type: application/json
+
+{
+  "SubnetId": "subnet-xxxxx"
+}
+```
+
+#### Desassociar Subnet
+```
+DELETE /__admin/route-tables/{rtId}/associations/{subnetId}
+```
+
+#### Deletar Route Table
+```
+DELETE /__admin/route-tables/{rtId}
+```
+
+### Internet Gateways
+
+#### Criar IGW
+```
+POST /__admin/internet-gateways/create
+Content-Type: application/json
+
+{
+  "Tags": []
+}
+```
+
+#### Listar IGWs
+```
+GET /__admin/internet-gateways
+```
+
+#### Obter IGW
+```
+GET /__admin/internet-gateways/{igwId}
+```
+
+#### Anexar a VPC
+```
+POST /__admin/internet-gateways/{igwId}/attach
+Content-Type: application/json
+
+{
+  "VpcId": "vpc-xxxxx"
+}
+```
+
+#### Desanexar de VPC
+```
+POST /__admin/internet-gateways/{igwId}/detach
+Content-Type: application/json
+
+{
+  "VpcId": "vpc-xxxxx"
+}
+```
+
+#### Deletar IGW
+```
+DELETE /__admin/internet-gateways/{igwId}
+```
+
+### VPC Endpoints
+
+#### Criar Endpoint (Gateway)
+```
+POST /__admin/vpc-endpoints/create
+Content-Type: application/json
+
+{
+  "VpcId": "vpc-xxxxx",
+  "ServiceName": "com.amazonaws.region.s3|dynamodb",
+  "VpcEndpointType": "Gateway",
+  "RouteTableIds": ["rtb-xxxxx"]
+}
+```
+
+#### Criar Endpoint (Interface)
+```
+POST /__admin/vpc-endpoints/create
+Content-Type: application/json
+
+{
+  "VpcId": "vpc-xxxxx",
+  "ServiceName": "com.amazonaws.region.lambda",
+  "VpcEndpointType": "Interface",
+  "SubnetIds": ["subnet-xxxxx"],
+  "SecurityGroupIds": ["sg-xxxxx"],
+  "PrivateDnsEnabled": true
+}
+```
+
+#### Listar Endpoints
+```
+GET /__admin/vpc-endpoints
+GET /__admin/vpc-endpoints?vpcIds=vpc-xxxxx
+GET /__admin/vpc-endpoints?vpcEndpointIds=vpce-xxxxx
+```
+
+#### Obter Endpoint
+```
+GET /__admin/vpc-endpoints/{epId}
+```
+
+#### Modificar Endpoint
+```
+POST /__admin/vpc-endpoints/{epId}/modify
+Content-Type: application/json
+
+{
+  "RouteTableIds": ["rtb-xxxxx"],
+  "SubnetIds": ["subnet-xxxxx"],
+  "PolicyDocument": {}
+}
+```
+
+#### Deletar Endpoint
+```
+DELETE /__admin/vpc-endpoints/{epId}
+```
+
+### Recursos
+
+#### Listar Todos os Recursos
+```
+GET /__admin/resources
+```
+
+Response inclui: VPCs, Subnets, RouteTables, InternetGateways, VPCEndpoints, NATGateways
+
+### Health Check
+
+```
+GET /__admin/health
+```
+
+Response: `{ "status": "ok", "service": "vpc" }`
+
+## Exemplos
+
+### Criar uma arquitetura VPC completa
+
+```bash
+# 1. Criar VPC
+VPC=$(curl -s -X POST http://localhost:4014/__admin/vpcs/create \
+  -H "Content-Type: application/json" \
+  -d '{"CidrBlock":"10.0.0.0/16"}' | jq -r '.Vpc.VpcId')
+
+# 2. Criar Subnets
+SUBNET_1=$(curl -s -X POST http://localhost:4014/__admin/subnets/create \
+  -H "Content-Type: application/json" \
+  -d "{\"VpcId\":\"$VPC\",\"CidrBlock\":\"10.0.1.0/24\",\"AvailabilityZone\":\"us-east-1a\"}" | jq -r '.Subnet.SubnetId')
+
+# 3. Criar Internet Gateway
+IGW=$(curl -s -X POST http://localhost:4014/__admin/internet-gateways/create \
+  -H "Content-Type: application/json" \
+  -d '{}' | jq -r '.InternetGateway.InternetGatewayId')
+
+# 4. Anexar IGW à VPC
+curl -s -X POST http://localhost:4014/__admin/internet-gateways/$IGW/attach \
+  -H "Content-Type: application/json" \
+  -d "{\"VpcId\":\"$VPC\"}"
+
+# 5. Criar Route Table
+RT=$(curl -s -X POST http://localhost:4014/__admin/route-tables/create \
+  -H "Content-Type: application/json" \
+  -d "{\"VpcId\":\"$VPC\"}" | jq -r '.RouteTable.RouteTableId')
+
+# 6. Adicionar rota padrão
+curl -s -X POST http://localhost:4014/__admin/route-tables/$RT/routes \
+  -H "Content-Type: application/json" \
+  -d "{\"DestinationCidrBlock\":\"0.0.0.0/0\",\"Target\":\"$IGW\",\"TargetType\":\"igw\"}"
+
+# 7. Associar Subnet com Route Table
+curl -s -X POST http://localhost:4014/__admin/route-tables/$RT/associations \
+  -H "Content-Type: application/json" \
+  -d "{\"SubnetId\":\"$SUBNET_1\"}"
+
+# 8. Criar VPC Endpoint S3
+curl -s -X POST http://localhost:4014/__admin/vpc-endpoints/create \
+  -H "Content-Type: application/json" \
+  -d "{\"VpcId\":\"$VPC\",\"ServiceName\":\"com.amazonaws.us-east-1.s3\",\"VpcEndpointType\":\"Gateway\",\"RouteTableIds\":[\"$RT\"]}"
+
+echo "Arquitetura criada com sucesso!"
+echo "VPC: $VPC"
+echo "Subnet: $SUBNET_1"
+echo "IGW: $IGW"
+echo "Route Table: $RT"
+```
+
+## Validações
+
+- **CIDR Overlap**: Evita subnets com CIDR blocks sobrepostos na mesma VPC
+- **Dependências**: Valida dependências ao deletar recursos
+- **Associações**: Evita associações duplicadas de subnets em route tables
+- **Attachments**: Permite um único IGW por VPC, múltiplos por IGW
+
+## Limites
+
+- Max 5 VPCs por simulador (configurável)
+- Max 10 subnets por VPC (configurável)
+- Max 20 rotes por route table
+- Max 5 endpoints por VPC
+- Sem limite de tags por recurso
+
+## Status da Implementação
+
+- ✅ VPCs (CRUD completo)
+- ✅ Subnets (CRUD completo)
+- ✅ Route Tables (CRUD + associações)
+- ✅ Internet Gateways (CRUD + attach/detach)
+- ✅ VPC Endpoints (CRUD + modificações)
+- ✅ NAT Gateways (básico)
+- ⏳ Network ACLs (futuro)
+- ⏳ Security Groups (futuro)
+- ⏳ VPN Connections (futuro)
+- ⏳ Peering (futuro)
+
+## Integração com CloudFormation
+
+O serviço VPC será integrado com CloudFormation para criar recursos via templates.
+
+## Notas Importantes
+
+1. O simulador VPC não faz roteamento real de tráfego - apenas simula o estado
+2. Subnets e VPCs são apenas gerenciamento de estado, não há isolamento real de rede
+3. Os dados são armazenados em memória e perdidos ao reiniciar
+4. Para persistência, implemente storage backend (arquivo, banco de dados)
+
+## Troubleshooting
+
+### "VPC not found"
+- Verifique se o VPC ID está correto
+- Use `GET /__admin/vpcs` para listar IDs
+
+### "Cannot delete VPC: VPC has subnets"
+- Delete as subnets primeiro ou desassocie as subnets
+
+### "CIDR block overlaps with existing subnets"
+- Escolha um CIDR block que não sobrescreva subnets existentes
+- Use subnets de 10.0.0.0/8 de forma não sobreposta
+
+### "Cannot delete Internet Gateway with attachments"
+- Desanexe o IGW da VPC primeiro com POST `/detach`
+
+## Contribuindo
+
+Para adicionar mais funcionalidades:
+
+1. Adicione o modelo em `models/`
+2. Implemente operações no `simulator.js`
+3. Adicione rotas no `server.js`
+4. Atualize este README
+
+## Licença
+
+MIT