DeployComunidade
Nível de dificuldade: Avançado (4 de 5)
AWS Emulator permite testar S3, DynamoDB e SQS localmente antes do deploy
A AWS anunciou o AWS Emulator em 11 de novembro de 2026: um endpoint local que recebe chamadas do AWS CLI e dos SDKs como se fossem dirigidas a serviços reais, mas processa tudo em memória, na sua máquina. Uma semana e meia depois, o desenvolvedor por trás do blog mickychog publicou na DEV Community um laboratório completo testando a ferramenta com uma API de telemetria em NestJS, cobrindo S3, DynamoDB e SQS numa única aplicação. O código, os scripts e as capturas de tela ficam no repositório aws-emulator-telemetry-lab, com guia em inglês e em espanhol.
Para quem faz deploy de aplicação AWS no dia a dia, ou automatiza esse deploy com um agente de código, o ganho é direto: dá para rodar o ciclo inteiro de escrever, testar e corrigir sem credenciais reais e sem o risco de uma rotina de teste mal escrita gerar uma fatura inesperada de SQS ou S3.
Em números
- 11 de novembro de 2026: data do anúncio oficial do AWS Emulator pela AWS.
- 80%: limiar de uso de CPU que, na API de exemplo, dispara um alerta via SQS.
- 000000000000: ID de conta que o emulador atribui ao ambiente simulado.
- 1.0.551: versão do AWS Emulator usada no laboratório, verificada em 21 de novembro de 2026.
O que você vai construir
O laboratório implementa uma API de telemetria simples em NestJS com TypeScript, usando o AWS SDK for JavaScript v3. Um cliente envia uma medição para POST /telemetry e o serviço executa, em sequência, três operações contra recursos emulados:
| Destino | Recurso | Finalidade |
|---|---|---|
| DynamoDB | AgentStatus | Substitui o status mais recente de um agente |
| S3 | telemetry-raw-logs | Salva um relatório JSON de cada medição |
| SQS | high-cpu-alerts | Envia um alerta quando cpuUsage >= 80 |
A tabela AgentStatus usa uma chave de partição string chamada agentId. Os objetos no S3 seguem o padrão logs/<agentId>/<uuid>.json, o que separa o histórico bruto (S3) do estado atual (DynamoDB). O repositório não coleta métricas de sistema automaticamente: os exemplos usam curl como emissor de telemetria, e não existe, por ora, um consumidor para a fila SQS.
Pré-requisitos
O ambiente verificado pelo autor do laboratório, em 21 de novembro de 2026, usou estas versões:
| Componente | Versão |
|---|---|
| SO | Linux Mint 22.3, x86_64 |
| Node.js / npm | 24.22.1 / 11.19.1 |
| AWS CLI | 2.36.29 |
| AWS Emulator | 1.0.551 |
| TypeScript | 6.0.3 |
| Vitest | 4.1.12 |
Além das ferramentas:
- Conta AWS real não é necessária: o emulador gera suas próprias credenciais e um certificado local em
~/.aws/emulator/9297/, sem exigir permissão IAM alguma. gitpara clonar o repositório.- No Linux Mint, o pacote
.debdo AWS Emulator segue o fluxo oficial de instalação e verificação de assinatura da AWS; o repositório do laboratório traz uma URL do pacote fixada na build testada.
Passo a passo
1. Suba o emulador num terminal (A):
aws-emulator --version
aws-emulatorDeixe rodando. O laboratório usa o endpoint HTTPS https://127.0.0.1:9297.
2. Configure o shell para chamadas locais, num terminal B:
mkdir -p ~/Proyectos
git clone https://github.com/mickychog/aws-emulator-telemetry-lab.git \
~/Proyectos/aws-emulator-telemetry-lab
cd ~/Proyectos/aws-emulator-telemetry-lab
source scripts/use-emulator.shO script aponta CLI e SDK para o endpoint local, seleciona us-east-1, usa as credenciais geradas pelo emulador e remove do ambiente qualquer AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN ou AWS_PROFILE herdados. É essencial usar source, e não executar o script como processo filho: só assim as variáveis ficam disponíveis no shell atual.
Verifique a conexão:
curl --fail --silent --show-error \
--cacert "$AWS_CA_BUNDLE" \
https://127.0.0.1:9297/__admin/health
aws sts get-caller-identityO health check deve retornar ok, e a conta simulada é 000000000000. Se aparecer outra conta, revise a configuração antes de seguir.
3. Inicialize os recursos e suba a API:
bash scripts/init-aws.shO script confere o endpoint e a conta via STS antes de criar (ou reaproveitar) os recursos nomeados, e espera a tabela AgentStatus ficar disponível.
cd backend
npm ci
if [ ! -f .env ]; then
cp .env.example .env
fi
npm run start:devO .env local define:
S3_BUCKET_NAME=telemetry-raw-logs
DYNAMODB_TABLE_NAME=AgentStatus
SQS_QUEUE_NAME=high-cpu-alertsA API escuta em http://127.0.0.1:3000 (o código fixa esse endereço e porta; não lê PORT). Esse listener HTTP é separado do endpoint HTTPS do emulador: o AppService recusa subir se AWS_ENDPOINT_URL não for exatamente https://127.0.0.1:9297.
Dois detalhes de configuração do SDK valem atenção para quem for adaptar o código para outro projeto:
- O S3 usa
forcePathStyle: true, necessário porque o emulador não resolve URLs de bucket no estilo virtual-hosted. - O SQS usa
useQueueUrlAsEndpoint: false, mantendo o transporte local configurado mesmo quando a URL de fila retornada parece uma URL real da AWS.
4. Envie telemetria normal, num terminal C:
curl -i -sS -X POST http://127.0.0.1:3000/telemetry \
-H 'Content-Type: application/json' \
-d '{
"agentId": "node-01",
"hostname": "linux-mint-lab",
"cpuUsage": 35.5,
"memoryUsage": 48.2
}'A resposta esperada é 201 Created, com status: "processed" e alertTriggered: false, mais um timestamp gerado e a chave do objeto no S3.
5. Dispare e inspecione um alerta de CPU alta:
{
"agentId": "node-02",
"hostname": "server-test",
"cpuUsage": 92.5,
"memoryUsage": 76.3
}No laboratório, essa chamada retornou alertTriggered: true. O limiar é 80% inclusive; o uso de memória é armazenado mas não dispara alerta, e requisições repetidas com CPU alta geram alertas repetidos.
Testando
Com o terminal configurado por use-emulator.sh, confira o status do item salvo no DynamoDB e a lista de objetos no S3:
aws dynamodb get-item --table-name AgentStatus \
--key '{"agentId":{"S":"node-01"}}'
aws s3 ls s3://telemetry-raw-logs/logs/node-01/Para conferir a mensagem na fila:
QUEUE_URL=$(aws sqs get-queue-url \
--queue-name high-cpu-alerts \
--query QueueUrl --output text)
aws sqs receive-message --endpoint-url "$AWS_ENDPOINT_URL" \
--queue-url "$QUEUE_URL" \
--max-number-of-messages 10 --wait-time-seconds 2Receber uma mensagem muda sua visibilidade temporariamente; não a apaga. Um contador de mensagens visíveis igual a zero, depois disso, não comprova que a mensagem foi deletada.
Para testar a validação de entrada, uma requisição com cpuUsage fora do intervalo 0-100 deve retornar 400 Bad Request antes mesmo de chamar o serviço. O ValidationPipe global do NestJS também rejeita campos extras, e exige que agentId e hostname sejam strings não vazias.
Por fim, os testes automatizados do repositório:
npx vitest run --config vitest.config.ts
npx vitest run --config vitest.config.e2e.ts
npm run build| Verificação | Resultado | Escopo |
|---|---|---|
| Testes unitários | 2 passaram | Delegação do controller e flag de alerta retornada |
| E2E HTTP | 3 passaram | POST válido, CPU acima de 100, agentId ausente |
| Build do NestJS | Passou | Compilação TypeScript |
O ponto mais útil do laboratório está exatamente aqui: ambas as suítes automatizadas mockam o AppService e não testam as operações do SDK nem a lógica do limiar de CPU contra o emulador. Elas rodam sem o emulador ligado.
O fluxo completo de S3, DynamoDB e SQS foi checado manualmente e registrado em capturas de tela; numa revisão posterior da documentação, testes e build rodaram de novo com sucesso, junto de checagens somente leitura no emulador, mas o fluxo manual completo de POST e armazenamento não foi reexecutado nessa revisão. Um teste HTTP passando e uma integração de serviço demonstrada respondem perguntas diferentes, e misturar as duas é um erro comum em relatório de cobertura.
Limpando os recursos
Como o AWS Emulator mantém tudo em memória, não existe uma etapa de delete-table ou s3 rm para evitar cobrança: não há cobrança real envolvida, e os recursos somem sozinhos quando o processo para. Ainda assim, para encerrar o laboratório de forma limpa:
- Pare o backend NestJS com
Ctrl+Cno terminal onde rodounpm run start:dev. - Pare o
aws-emulatorcomCtrl+Cno terminal A; isso descarta a tabelaAgentStatus, o buckettelemetry-raw-logse a filahigh-cpu-alertssimulados. - Para retomar o trabalho depois, é preciso subir o emulador de novo e rodar
scripts/init-aws.shenpm run start:devoutra vez: os dados anteriores não voltam. - Não é preciso desabilitar verificação de TLS em nenhum momento; o laboratório usa a CA gerada pelo próprio emulador.
Próximos passos
O próprio autor do laboratório lista o que falta antes de considerar esse desenho pronto para produção. A escrita atual é sequencial (DynamoDB, depois S3, depois SQS opcionalmente), sem transação entre as três: uma falha no meio do caminho pode deixar dado parcial, e uma nova tentativa pode criar objetos ou mensagens duplicadas. Faltam também autenticação, autorização, limitação de taxa, tratamento de idempotência e um consumidor para a fila de alertas.
As melhorias sugeridas incluem testes de serviço na fronteira exata dos 80% de CPU, testes de falha parcial, a implementação de um consumidor SQS e um workflow automatizado de integração contra o próprio emulador, em vez de depender de verificação manual.
Vale frisar o limite da ferramenta em si: a documentação oficial da AWS trata o emulador como ferramenta de desenvolvimento e teste. Os recursos vivem em memória e somem quando o processo para, e seu comportamento não comprova compatibilidade com produção nem a correção de políticas IAM reais.
Para quem usa agente de código no laço de desenvolvimento (gerando testes, rodando builds, iterando sobre erros de SDK), isso é exatamente o tipo de ambiente descartável que evita queimar cota ou gerar cobrança por engano enquanto o agente tenta várias vezes até acertar a chamada certa; só não substitui, antes do deploy real, uma passada por um ambiente AWS de fato, com IAM e limites reais.
Fonte: DEV Community — #aws
Serviços neste textoDeployAgentes de código
Leve para a sua IA
Decida com o seu assistente, com o contexto deste texto já montado.
1. O que você quer saber
Ver o prompt
Li no AWS Hub: "AWS Emulator permite testar S3, DynamoDB e SQS localmente antes do deploy" (https://awshub.com.br/comunidade/aws-emulator-permite-testar-s3-dynamodb-e-sqs-localmente-antes-do-deploy). Resumo: Um laboratório publicado na comunidade DEV mostra como rodar uma API NestJS completa, com S3, DynamoDB e SQS emulados, sem tocar numa conta real da AWS. Serviços: Deploy, Agentes de código Minha stack: [descreva em uma linha: serviços, linguagem, volume, região] Isso muda alguma coisa na minha arquitetura? O que eu faria diferente a partir de amanhã?