As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # AWS Lambda com LocalStack suporte Crie, teste e depure seus aplicativos sem servidor com LocalStack suporte no. AWS Toolkit for Visual Studio Code LocalStack é um emulador de AWS nuvem que permite testes locais de aplicativos sem servidor. Para obter informações adicionais sobre AWS Lambda, consulte o *Guia do [AWS Lambda](https://docs.aws.amazon.com//lambda/latest/dg/welcome.html)desenvolvedor*. Para saber mais sobre LocalStack, visite o site deles [LocalStack](https://www.localstack.cloud/). ## Pré-requisitos A seguir estão os pré-requisitos para trabalhar LocalStack no VS Code. **nota** *A LocalStack CLI é instalada durante o processo de configuração, mas se você preferir uma versão diferente da LocalStack CLI, a versão mínima necessária é 4.8.0.* + É necessária uma conta de aplicativo LocalStack Web para acessar todos os recursos disponíveis nos LocalStack níveis gratuito e pago. LocalStack a edição comunitária está disponível sem uma conta. + É necessário trabalhar com o Docker LocalStack no VS Code. Para obter mais informações sobre LocalStack os requisitos do Docker, consulte o tópico [Imagens do LocalStack Docker](https://docs.localstack.cloud/aws/capabilities/config/docker-images/) na LocalStack documentação. + **Recomendado:** o AWS Command Line Interface (AWS CLI) ajuda você a trabalhar com serviços em seu ambiente de nuvem simulado. ## Instalando LocalStack Para instalar versões em camadas LocalStack gratuitas e pagas, conclua as etapas a seguir. **nota** Para obter instruções sobre como configurar a edição LocalStack Community, consulte o conteúdo da *LocalStackcomunidade* na LocalStack seção *Configuração* deste tópico. 1. No AWS kit de ferramentas, expanda o explorador do **APPLICATION BUILDER**. 1. Escolha o botão **Abrir passo a passo** para abrir a guia Passo a passo para **começar a criar seu aplicativo** no editor de código do VS Code. 1. No passo a passo, escolha **Instalar LocalStack** para iniciar o processo de LocalStack instalação no VS Code. ## Conf LocalStackiguração Depois de instalar a LocalStack extensão para o VS Code, você poderá ver um dos seguintes indicadores quando a configuração for necessária: + Na barra de status do VS Code, localizada no canto inferior esquerdo do IDE por padrão, o LocalStack status é vermelho. + O VS Code solicita que você configure. LocalStack Há dois tipos de instalação e configurações para LocalStack, dependendo da versão que LocalStack você está usando. As seções com guias a seguir descrevem cada processo LocalStack de configuração. **nota** LocalStack tokens de autenticação são necessários para as versões gratuitas e pagas do LocalStack. Para obter informações específicas sobre LocalStack preços, consulte o guia de preços [Escolha seu plano](https://www.localstack.cloud/pricing). ### LocalStack níveis gratuitos e pagos Há duas maneiras de configurar LocalStack. + No prompt de **configuração do VS Code LocalStack para começar**, escolha o botão **Configurar**. + Na barra de status do VS Code, escolha o ícone de LocalStack status para abrir o prompt **Configuração LocalStack para começar** e, em seguida, escolha o botão **Configuração**. O sistema segue as estas etapas durante a configuração: 1. Instala a LocalStack CLI. 1. Verifica se você tem uma LocalStack conta. 1. Se você tiver uma LocalStack conta, o sistema o guiará pelo processo de autenticação em seu navegador padrão. Da mesma forma, se você não tiver uma LocalStack conta, o sistema orientará você na configuração da conta antes do processo de autenticação. Depois de configurado, o LocalStack status LocalStack é atualizado na barra de status do VS Code. **nota** Se você não criou um AWS perfil para LocalStack, um novo será criado automaticamente para você como parte do processo de LocalStack configuração. ### LocalStack Comunidade A edição Community do LocalStack é gratuita e não exige que você se inscreva em uma conta, ela é executada a partir de uma imagem do Docker que não requer uma licença. Para obter detalhes adicionais sobre a LocalStack Community Edition, consulte a documentação de [imagens da LocalStack comunidade](https://docs.localstack.cloud/references/docker-images/). As seções a seguir descrevem os pré-requisitos e a configuração básica necessária para trabalhar com a edição LocalStack comunitária no VS Code. **Iniciar uma nova instância** Para iniciar uma nova instância do LocalStack Community, conclua o procedimento a seguir. **nota** O exemplo a seguir inicia uma instância de contêiner LocalStack na porta 4566. Se você especificar valores de porta diferentes, deverá atualizar o valor da porta especificado no procedimento localizado na seção *Configurando o AWS kit AWS CLI de ferramentas*. 1. No VS Code, abra o terminal do VS Code pressionando **ctrl \$1 `(backtick)**. 1. Digite o seguinte no terminal. **Mac:** ``` docker run -d --name localstack_main \ >> -p 4566:4566 \ >> -v /var/run/docker.sock:/var/run/docker.sock \ >> localstack/localstack ``` **Windows:** ``` docker run -d --name localstack_main ` >> -p 4566:4566 ` >> -v /var/run/docker.sock:/var/run/docker.sock ` >> localstack/localstack ``` 1. O terminal será atualizado com o status da instância do Docker quando o processo for concluído. Essa instância em contêiner do LocalStack fornece acesso aos AWS serviços que você especificou durante o processo de download. **Configurando a CLI LocalStack para o Docker.** Para configurar o AWS CLI e o AWS Toolkit para trabalhar LocalStack no Docker, configure um novo perfil concluindo as seguintes etapas: 1. No VS Code, abra o terminal do VS Code pressionando **ctrl \$1 `(backtick)**. 1. Digite o seguinte no terminal. ``` ~/.aws/credentials [localstack] aws_access_key_id = test aws_secret_access_key = test ~/.aws/config [profile localstack] region = us-east-1 output = json endpoint_url = http://localhost:4566 [default localstack endpoint] ``` 1. O AWS kit de ferramentas detecta seu LocalStack perfil e atualiza o menu de status da conexão. Após a configuração, escolher seu LocalStack perfil na seção de AWS perfil da barra de status torna seus LocalStack recursos visíveis no AWS explorador. Além disso, você pode visualizar seus LocalStack registros na guia **Saída** do terminal VS Code. ## Começando LocalStack no VS Code Você pode começar a LocalStack usar qualquer um dos seguintes métodos: **Começando LocalStack pela barra de status do VS Code** 1. No VS Code, navegue até a barra de status e escolha o LocalStack botão **Iniciar** para iniciar LocalStack. 1. A barra de status do VS Code é atualizada quando é LocalStack iniciada com sucesso. **Começando LocalStack pela **paleta de comandos** do VS Code** 1. No VS Code, abra a **Paleta de comandos** pressionando **Cmd \$1 Shift \$1 P** (Mac) ou **Control \$1 Shift \$1 P** (Windows). 1. Na **Paleta de Comandos**, insira **Start LocalStack** na barra de pesquisa e escolha-a na lista quando ela for preenchida nos resultados. 1. A barra de status do VS Code é atualizada quando é LocalStack iniciada com sucesso. **A LocalStack partir do terminal VS Code** 1. No VS Code, abra o terminal do VS Code pressionando **ctrl \$1 `(backtick)**. 1. No terminal do VS Code, insira o comando **localstack start** da CLI. 1. A barra de status do VS Code é atualizada quando é LocalStack iniciada com sucesso. ## Criando um exemplo de aplicativo sem servidor Para começar a trabalhar com LocalStack o VS Code, você precisa de um exemplo de aplicativo sem servidor. Se você já tem um aplicativo existente em sua AWS conta, pode implantá-lo localmente usando LocalStack ou criar um novo aplicativo com o AWS Serverless Land. Para saber mais sobre como criar uma aplicação com o Serverless Land no AWS Toolkit, consulte o tópico [Trabalhar com o AWS Serverless Land](https://docs.aws.amazon.com//toolkit-for-vscode/latest/userguide/serverlessland-overview.html) neste guia do usuário. Para obter informações detalhadas sobre o Serverless Land, consulte a página inicial principal do aplicativo web [Serverless Land](https://serverlessland.com/). ## Testando e depurando funções do Lambda com LocalStack Testar e depurar suas funções do Lambda na extensão LocalStack VS Code é semelhante a trabalhar com suas funções implantadas na nuvem. AWS A principal diferença é que sua instância do AWS Toolkit deve ser autenticada com sua LocalStack conta para implantar e depurar suas funções. LocalStack **nota** Os recursos de teste e depuração descritos nesta seção não estão disponíveis para LocalStack a Community Edition. Para trabalhar com o LocalStack VS Code, conecte-se ao seu LocalStack perfil no AWS Toolkit. Quando seu LocalStack perfil está ativo, a barra de status do VS Code mostra **AWS: profile:localstack (endpoint personalizado)** com uma marca de seleção. Para obter informações detalhadas sobre como trabalhar com suas funções do Lambda no AWS kit de ferramentas, consulte o tópico [Trabalhando com AWS Lambda funções](https://docs.aws.amazon.com//toolkit-for-vscode/latest/userguide/remote-lambda.html) neste guia do usuário.