Visão geral

LocalStack é um emulador de serviço em nuvem executado em um único contêiner em seu laptop ou ambiente de CI. Com LocalStack, você pode executar seus aplicativos AWS ou Lambdas inteiramente em sua máquina local sem se conectar a um provedor de nuvem remoto! Esteja você testando aplicativos CDK complexos ou configurações do Terraform, ou apenas começando a aprender sobre os serviços da AWS, o LocalStack ajuda a acelerar e simplificar seu fluxo de trabalho de teste e desenvolvimento.

LocalStack oferece suporte a um número crescente de serviços AWS, como AWS Lambda, S3, Dynamodb, Kinesis, SQS, SNS e muitos mais! A versão Pro do LocalStack oferece suporte a APIs adicionais e recursos avançados. Você pode encontrar uma lista abrangente de APIs suportadas em nossa página Cobertura de recursos.

LocalStack também oferece recursos adicionais para facilitar sua vida como desenvolvedor de nuvem! Confira os guias do usuário do LocalStack para obter mais informações.

Instalar

A maneira mais rápida de começar a usar o LocalStack é usando a CLI do LocalStack. Ele permite que você inicie e gerencie o contêiner LocalStack Docker diretamente por meio de sua linha de comando. Certifique-se de que sua máquina tenha um ambiente docker funcional instalado antes de continuar.

Brew (macOS ou Linux com Homebrew)

Instale o LocalStack CLI por meio de nosso LocalStack Brew Tap oficial:

 preparar instalação localstack/tap/localstack-cli

Download binário (MacOS, Linux, Windows)

Se o Brew não estiver instalado em sua máquina, você poderá baixar o binário CLI LocalStack pré-construído diretamente:

Visite localstack/localstack-cli e baixe a versão mais recente para sua plataforma.
Extraia o arquivo baixado para um diretório incluído na sua variável PATH :

Para MacOS/Linux, use o comando: sudo tar xvzf ~/Downloads/localstack-cli-*-darwin-*-onefile.tar.gz -C /usr/local/bin

PyPI (Mac OS, Linux, Windows)

LocalStack é desenvolvido em Python. Para instalar a CLI LocalStack usando pip , execute o seguinte comando:

 python3 -m pip instalar pilha local

A instalação localstack-cli permite executar a imagem Docker que contém o tempo de execução LocalStack. Para interagir com os serviços locais da AWS, você precisa instalar a CLI awslocal separadamente. Para obter diretrizes de instalação, consulte a documentação awslocal .

Importante : Não use sudo ou execute como usuário root . LocalStack deve ser instalado e iniciado inteiramente sob um usuário local não root. Se você tiver problemas com permissões no macOS High Sierra, instale com pip install --user localstack

Início rápido

Inicie o LocalStack dentro de um contêiner Docker executando:

 % pilha local início -d

     __ _______ __ __
    // ____ _________ _/ / ___// /_____ ______/ /__
   / / / __ / ___/ __ `/ /__ / __/ __ `/ ___/ //_/
  / /___/ /_/ / /__/ /_/ / /___/ / /_/ /_/ / /__/ ,<
 /_____/____/___/__,_/_//____/__/__,_/___/_/|_|

 ? LocalStack CLI 3.8.0
 ? Perfil: padrão

[12:47:13] iniciando LocalStack no modo Docker?                       pilha local.py:494
           preparando o ambiente bootstrap.py:1240
           configurando o contêiner bootstrap.py:1248
           iniciando o contêiner bootstrap.py:1258
[12:47:15] desanexando bootstrap.py:1262

Você pode consultar o status dos respectivos serviços no LocalStack executando:

 % serviços de status de pilha local
┏━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━ ━┓
┃ Serviço ┃ Status ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━ ━┩
│ acm │ ✔ disponível │
│ apigateway │ ✔ disponível │
│ formação de nuvem │ ✔ disponível │
│ cloudwatch │ ✔ disponível │
│ configuração │ ✔ disponível │
│ dinamodb │ ✔ disponível │
...

Para usar o SQS, um serviço de enfileiramento de mensagens distribuídas totalmente gerenciado, no LocalStack, execute:

 % awslocal sqs create-queue --queue-name sample-queue
{ "QueueUrl": "http://sqs.us-east-1.localhost.localstack.cloud:4566/000000000000/sample-queue"}

Saiba mais sobre os serviços LocalStack AWS e como usá-los com a CLI awslocal do LocalStack.

Correndo

Você pode executar o LocalStack por meio das seguintes opções:

CLI LocalStack
Docker
Composição do Docker
Leme

Uso

Para começar a usar o LocalStack, confira nossa documentação.

Configuração LocalStack
LocalStack em CI
Integrações LocalStack
Ferramentas LocalStack
Compreendendo o LocalStack
Perguntas frequentes

Para usar LocalStack com uma interface gráfica do usuário, você pode usar os seguintes clientes de UI:

Aplicativo da Web LocalStack
Área de trabalho LocalStack
Extensão Docker LocalStack

Lançamentos

Consulte as versões do GitHub para ver a lista completa de alterações de cada versão. Para notas de versão estendidas, consulte a discussão do LocalStack.

Contribuindo

Se você estiver interessado em contribuir com LocalStack:

Comece lendo nosso guia de contribuição.
Confira nosso guia de configuração do ambiente de desenvolvimento.
Navegue em nossa base de código e abra problemas.

Agradecemos todas as contribuições e feedback que recebemos.

Entre em contato

Entre em contato com a equipe LocalStack para relatar? questões, voto positivo? solicitações de recursos, ?? faça perguntas de suporte ou ?️ discuta o desenvolvimento de nuvem local:

Comunidade LocalStack Slack
Página de discussão do LocalStack
Rastreador de problemas LocalStack GitHub

Colaboradores

Agradecemos a todas as pessoas que contribuíram para este projeto.

Apoiadores

Agradecemos também a todos os nossos apoiadores que doaram para o projeto. Você pode se tornar um apoiador do Open Collective.

Patrocinadores

Você também pode apoiar este projeto tornando-se um patrocinador do Open Collective. Seu logotipo aparecerá aqui junto com um link para seu site.

Licença

Esta versão do LocalStack é lançada sob a licença Apache, versão 2.0 (consulte LICENSE). Ao baixar e usar este software, você concorda com o Contrato de Licença do Usuário Final (EULA).

Expandir

Informações adicionais