ministackorg/ministack

O que é?

Recursos principais

• 01Emula mais de 60 serviços da AWS em uma única porta, incluindo S3, SQS, DynamoDB, Lambda e Step Functions.
• 02Funciona com boto3, AWS CLI, Terraform, CDK e Pulumi, bastando alterar a URL do endpoint.
• 03Isola o estado por conta (usando a access key) e por região.
• 04Executa containers reais de Postgres, MySQL, Redis e Valkey para RDS e ElastiCache.
• 05Oferece um endpoint para limpar o estado e endpoints de inspeção para uso em suítes de testes.

Casos de uso

• Executar testes de integração que dependem da AWS em CI, sem credenciais reais da AWS.
• Desenvolver funções Lambda e fluxos de trabalho orientados a eventos localmente, usando SQS, SNS e EventBridge emulados.
• Testar código de infraestrutura em Terraform ou CDK antes de implantá-lo na AWS.
• Substituir uma configuração paga do LocalStack em ambientes de desenvolvimento local.

Início rápido

1. 1

   Instalar pelo PyPI

   pip install ministack
2. 2

   Iniciar o MiniStack (executado na porta 4566)

   ministack
3. 3

   Verificar se o servidor está em execução

   curl http://localhost:4566/_ministack/health

Antes de usar

• !Consultas SQL do Athena e alguns recursos de bancos de dados reais exigem a imagem completa do Docker, que é maior.
• !Os contêineres de RDS, ElastiCache, ECS e Lambda exigem a montagem do socket do Docker.

Em coleções

Tópicos

Perguntas frequentes

O que é ministack?

Emulador local, gratuito e open source da AWS, com mais de 60 serviços em uma única porta e compatível com boto3, AWS CLI e Terraform. O MiniStack é um emulador local da AWS que permite executar S3, SQS, SNS, DynamoDB, Lambda, IAM, EC2, Step Functions e dezenas de outros serviços da AWS na própria máquina ou em CI, sem precisar de uma conta AWS. Todos os serviços ficam disponíveis em um único endpoint, na porta 4566 por padrão, então basta alterar a URL do endpoint nas configurações existentes de boto3, AWS CLI, Terraform, CDK e Pulumi.

ministack é gratuito? Qual é a licença?

ministack é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

ministack ainda é mantido?

Manutenção ativa. O último commit de ministack foi em 5 de nov. de 2026.

Para que posso usar ministack?

Executar testes de integração que dependem da AWS em CI, sem credenciais reais da AWS. Desenvolver funções Lambda e fluxos de trabalho orientados a eventos localmente, usando SQS, SNS e EventBridge emulados. Testar código de infraestrutura em Terraform ou CDK antes de implantá-lo na AWS. Substituir uma configuração paga do LocalStack em ambientes de desenvolvimento local.

Como instalar ministack?

Instalar pelo PyPI: pip install ministack Iniciar o MiniStack (executado na porta 4566): ministack Verificar se o servidor está em execução: curl http://localhost:4566/_ministack/health

Onde consigo ministack?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ministackorg/ministack