WhatsApp

AWS Emulator permite testar serviços da AWS localmente no Linux

AWS Emulator executa APIs de S3, DynamoDB, SQS e Lambda localmente para testes com AWS CLI e OpenTofu em Linux.

Por Jaime Linhares · 22/11/2026

O AWS Emulator permite testar chamadas a S3, DynamoDB, SQS e Lambda em uma máquina Linux, sem conta AWS enquanto o programa está em execução. O guia cobre a instalação no Ubuntu 26.04 e no Rocky Linux 10, além do uso da AWS CLI e de uma configuração OpenTofu. Os testes foram feitos em novembro de 2026 com AWS Emulator 1.0.553, AWS CLI 2.42.1 e OpenTofu 1.13.9.

O que o AWS Emulator oferece

O emulador é um programa local que responde a chamadas das APIs da AWS e mantém os recursos em memória. O endpoint padrão usa HTTPS em 127.0.0.1:9297; a opção -p permite escolher outra porta, enquanto -p 0 seleciona uma porta livre. Ao encerrar o processo, os recursos criados durante a execução são apagados.

Distribuído pela AWS sob licença CC0, o programa não tem console nem daemon: é iniciado em um terminal, e clientes como AWS CLI, SDKs e provedores do Terraform enviam as chamadas ao endpoint local. O código-fonte está no repositório aws/aws-emulator. Por padrão, a identidade usa a conta 000000000000, o usuário emulator e uma nova chave EMULATOR a cada inicialização.

Há pacotes Debian e RPM para x86_64 e aarch64; no macOS e no Windows, é preciso criar uma imagem Docker. A telemetria fica ativada por padrão e pode ser desabilitada por uma opção, variável de ambiente ou configuração em config.toml, conforme a necessidade do ambiente de desenvolvimento.

Requisitos e limites do emulador

O roteiro cobre Ubuntu 26.04 e Rocky Linux 10, e os testes usaram duas máquinas virtuais em nuvem, app-node-1 e app-node-2, cada uma com 2 vCPUs e 4 GB de RAM. Essa configuração é apresentada como piso para rodar o emulador e as ferramentas de linha de comando, não como recomendação de dimensionamento.

Reserve cerca de 1,5 GB de espaço livre para os pacotes e a AWS CLI. O RPM tem 193 MB para download e ocupa aproximadamente 1,1 GB instalado em /opt/aws-emulator, portanto vale conferir o espaço disponível antes de instalar em volumes de sistema menores.

O emulador é voltado a desenvolvimento local e tarefas de integração contínua; não é indicado para produção, testes de segurança ou de carga, testes entre contas ou uso prolongado. A documentação da AWS informa que a compatibilidade foi verificada com o serviço real na região us-west-2; embora aceite outras regiões, o programa não mantém os recursos separados por região.

Os testes também encontraram respostas 501 para operações sem implementação, limites fixos e negações de IAM que, segundo a documentação, não deveriam ocorrer. Por isso, o ambiente é útil para exercitar chamadas e fluxos locais, mas comportamentos de segurança precisam ser confirmados em uma conta AWS real.

Baixe e verifique os pacotes

Os pacotes são publicados em um endereço fixo chamado latest, que sempre entrega a versão mais recente. No Ubuntu, baixe o pacote Debian, a assinatura e a chave de publicação da AWS; faça a verificação antes da instalação, pois uma assinatura inválida é motivo para excluir o arquivo.

curl -fsSLo aws-emulator.deb https://downloads.aws.com/aws-emulator/packages/aws-emulator/LTS/latest/aws-emulator_amd64.deb curl -fsSLo aws-emulator_amd64.deb.sig https://downloads.aws.com/aws-emulator/packages/aws-emulator/LTS/latest/aws-emulator_amd64.deb.sig curl -fsSLo aws-publishing.asc https://downloads.aws.com/keys/gpg/current.asc gpg --import aws-publishing.asc gpg --fingerprint [email protected]

Confira se a impressão digital exibida é 98BC F336 A3BE 53B7 34E9 67C5 2E5B F49B D940 F624. Como a assinatura é publicada para o nome aws-emulator_amd64.deb, copie o pacote para esse nome e valide-o com gpg antes de prosseguir com a instalação.

cp aws-emulator.deb aws-emulator_amd64.deb gpg --verify aws-emulator_amd64.deb.sig aws-emulator_amd64.deb

O resultado esperado inclui Good signature. O aviso de que a chave não tem uma assinatura de confiança é esperado depois da conferência manual da impressão digital. No Rocky Linux 10, instale o RPM pelo URL com dnf; no Ubuntu, use apt para instalar o pacote Debian local.

sudo apt-get install -y ./aws-emulator.deb sudo dnf install -y https://downloads.aws.com/aws-emulator/packages/aws-emulator/LTS/latest/aws-emulator-x86_64.rpm

No Rocky, rpm -qi aws-emulator mostra o identificador 2e5bf49bd940f624 no campo Signature, mas isso apenas confirma que o pacote tem uma assinatura. Por padrão, dnf não verifica a assinatura de pacotes instalados por URL ou arquivo local; para validar o RPM, baixe também o arquivo .rpm.sig e use gpg --verify antes da instalação.

Depois de instalar, confirme a versão com aws-emulator -v. Como o endereço latest sempre entrega o build mais novo, uma execução de CI que precise ser repetida deve guardar o pacote testado e instalar esse mesmo arquivo, em vez de baixar novamente a versão mais recente.

Instale a AWS CLI v2

O Ubuntu 26.04 não oferece um pacote awscli nos repositórios usados pelo guia, então a instalação pela apt resulta em “Package 'awscli' has no installation candidate”. Instale unzip com o comando da distribuição e use o instalador oficial da AWS CLI v2.

sudo apt-get install -y unzip sudo dnf install -y unzip curl -fsSLo awscliv2.zip https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip unzip -q awscliv2.zip sudo ./aws/install aws --version

O instalador inclui seu próprio Python e cria o comando em /usr/local/bin/aws, de modo que uma atualização do Python do sistema não altera o interpretador usado pela CLI. No teste, a versão informada foi aws-cli/2.42.1 Python/3.14.10 Linux/7.0.0-1017-gcp exe/x86_64.ubuntu.26.

Não execute aws configure: o emulador cria seus próprios arquivos de configuração e credenciais quando é iniciado. Os testes do guia usaram AWS Emulator 1.0.553 e OpenTofu 1.13.9, além da AWS CLI 2.42.1, em novembro de 2026 nas duas distribuições Linux.

Inicie o emulador e configure a sessão

O programa roda em primeiro plano por padrão. Para mantê-lo em execução enquanto o terminal fica disponível, inicie-o em segundo plano e grave stdout e stderr em arquivos separados: stdout contém linhas de log JSON, enquanto stderr apresenta o aviso sobre telemetria.

nohup aws-emulator > ~/emulator.log 2> ~/emulator.err &

Consulte a rota de integridade usando a CA do emulador e repita a consulta até receber ok. Nos testes em ambas as distribuições e após reinicializações, a rota respondeu entre 0,4 e 0,9 segundo depois do início, tempo que permite iniciar uma instância nova para cada tarefa de teste.

curl -s --cacert ~/.aws/emulator/9297/ca.pem https://127.0.0.1:9297/__admin/health; echo

Os arquivos em ~/.aws/emulator/9297/ pertencem a uma execução em uma porta e têm permissão 0600. O emulador apaga esse diretório quando para e recria os arquivos na próxima inicialização: emulator_credentials contém a chave da execução, ca.pem é a CA autoassinada e truststore.p12 guarda a mesma CA para clientes Java.

O arquivo config reúne a região, o endpoint, o pacote da CA e a assinatura SigV4 para S3. Consulte-o no caminho criado pelo emulador; os caminhos absolutos da configuração vinculam esse perfil ao usuário que iniciou o programa.

cat ~/.aws/emulator/9297/config [default] region = us-east-1 endpoint_url = https://127.0.0.1:9297 ca_bundle = /home/maureen/.aws/emulator/9297/ca.pem s3 = signature_version = s3v4

Para direcionar as ferramentas AWS abertas naquele shell ao endpoint local, crie ~/emulator.env e carregue o arquivo antes de executar os testes. As variáveis apontam para a configuração, as credenciais e a CA daquela execução do emulador.

vim ~/emulator.env

A última linha remove credenciais AWS reais exportadas no shell; isso evita que uma chamada sem AWS_ENDPOINT_URL use por engano as chaves encontradas no ambiente. Mantenha o endpoint definido e carregue o arquivo de ambiente na sessão que executará os comandos.

export AWS_ENDPOINT_URL=https://127.0.0.1:9297 export AWS_SHARED_CREDENTIALS_FILE=~/.aws/emulator/9297/emulator_credentials export AWS_CONFIG_FILE=~/.aws/emulator/9297/config export AWS_CA_BUNDLE=~/.aws/emulator/9297/ca.pem export AWS_EC2_METADATA_DISABLED=true export AWS_DISABLE_HOST_PREFIX_INJECTION=true export AWS_REGION=us-east-1 export AWS_DEFAULT_REGION=us-east-1 unset AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_SESSION_TOKEN AWS_PROFILE

Carregue o arquivo e consulte o STS antes de começar os testes, para confirmar a identidade e a conta de destino. A resposta esperada inclui a conta 000000000000 e o usuário emulator; se aparecer a conta real, corrija o ambiente antes de executar outras chamadas.

source ~/emulator.env aws sts get-caller-identity

A AWS CLI precisa da CA do emulador, fornecida por AWS_CA_BUNDLE ou pela linha ca_bundle do arquivo config. Sem ambas, as chamadas falham com CERTIFICATE_VERIFY_FAILED por causa do certificado autoassinado; carregue novamente o arquivo de ambiente em vez de usar --no-verify-ssl.

O certificado cobre os endereços de loopback e localhost. Como os arquivos do diretório da porta são apagados quando o emulador para, mantenha os scripts apontados para ~/.aws/emulator/9297/ em vez de copiar ca.pem para outro local.

Teste operações no S3

Com o ambiente carregado, os comandos usuais da AWS CLI podem criar um bucket, enviar um arquivo, listar os objetos e ler o conteúdo de volta para a saída do terminal. O exemplo usa o bucket app-artifacts e grava uma mensagem de teste em hello.txt.

aws s3 mb s3://app-artifacts echo "hello from app-node-1" > hello.txt aws s3 cp hello.txt s3://app-artifacts/ aws s3 ls s3://app-artifacts/ aws s3 cp s3://app-artifacts/hello.txt -

O resultado esperado inclui o bucket, o objeto de 22 bytes com seu horário e o mesmo texto lido de volta. Se o comando mb retornar erro de credenciais, carregue novamente o arquivo de ambiente: sem ele, a CLI pode tentar acessar a AWS real.

Também é possível criar uma URL pré-assinada para o objeto e definir sua validade em 300 segundos. No teste, a URL retornada usou https://127.0.0.1:9297 e o formato path-style, sem exigir nomes DNS para o bucket; a busca do arquivo com a CA do emulador retornou o mesmo texto.

aws s3 presign s3://app-artifacts/hello.txt --expires-in 300

O emulador também responde a APIs de DynamoDB, SQS e Lambda, como informa a descrição do projeto, mas o trecho disponível do guia detalha aqui apenas o fluxo completo de S3. Respostas 501 e limites fixos encontrados nos testes devem ser considerados ao avaliar quais operações servem para cada conjunto de testes.

Visitar site
Informações deste conteúdo

Tecnologias: AWS CLI, AWS Emulator, DynamoDB, Linux, OpenTofu, SQS

Carreiras: Administrador Linux, Administrador de Cloud, Desenvolvedor Cloud, Engenheiro de Cloud, Especialista em AWS

Idiomas: Português

Tags: api, aws, cloud, dynamodb, linux, s3, terraform, ubuntu