AWS HubAWS HubSão Paulo operando · 2 eventos no mundo

DeployComunidade

Nível de dificuldade: Avançado (4 de 5)

AWS Emulator permite testar S3, DynamoDB e SQS localmente antes do deploy

Por AWS Hub8 min de leitura

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:

DestinoRecursoFinalidade
DynamoDBAgentStatusSubstitui o status mais recente de um agente
S3telemetry-raw-logsSalva um relatório JSON de cada medição
SQShigh-cpu-alertsEnvia 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:

ComponenteVersão
SOLinux Mint 22.3, x86_64
Node.js / npm24.22.1 / 11.19.1
AWS CLI2.36.29
AWS Emulator1.0.551
TypeScript6.0.3
Vitest4.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.
  • git para clonar o repositório.
  • No Linux Mint, o pacote .deb do 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):

bash
aws-emulator --version
aws-emulator

Deixe rodando. O laboratório usa o endpoint HTTPS https://127.0.0.1:9297.

2. Configure o shell para chamadas locais, num terminal B:

bash
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.sh

O 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:

bash
curl --fail --silent --show-error \
 --cacert "$AWS_CA_BUNDLE" \
 https://127.0.0.1:9297/__admin/health
aws sts get-caller-identity

O 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
bash scripts/init-aws.sh

O 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.

bash
cd backend
npm ci
if [ ! -f .env ]; then
 cp .env.example .env
fi
npm run start:dev

O .env local define:

S3_BUCKET_NAME=telemetry-raw-logs
DYNAMODB_TABLE_NAME=AgentStatus
SQS_QUEUE_NAME=high-cpu-alerts

A 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:

bash
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:

json
{
 "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:

bash
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:

bash
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 2

Receber 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:

bash
npx vitest run --config vitest.config.ts
npx vitest run --config vitest.config.e2e.ts
npm run build
VerificaçãoResultadoEscopo
Testes unitários2 passaramDelegação do controller e flag de alerta retornada
E2E HTTP3 passaramPOST válido, CPU acima de 100, agentId ausente
Build do NestJSPassouCompilaçã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+C no terminal onde rodou npm run start:dev.
  • Pare o aws-emulator com Ctrl+C no terminal A; isso descarta a tabela AgentStatus, o bucket telemetry-raw-logs e a fila high-cpu-alerts simulados.
  • Para retomar o trabalho depois, é preciso subir o emulador de novo e rodar scripts/init-aws.sh e npm run start:dev outra 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ã?

Newsletter semanal

A semana da AWS, em português

Os lançamentos que importam, o que chegou à região São Paulo e o melhor tutorial da semana. Toda sexta, gratuita.