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 Lambdadesenvolvedor. Para saber mais sobre LocalStack, visite o site deles LocalStack
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
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.
-
No AWS kit de ferramentas, expanda o explorador do APPLICATION BUILDER.
-
Escolha o botão Abrir passo a passo para abrir a guia Passo a passo para começar a criar seu aplicativo no editor do VS Code.
-
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
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.
Durante a configuração, o sistema segue as seguintes etapas:
-
Instala a LocalStack CLI.
-
Verifica se você tem uma LocalStack conta.
-
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.
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
Lançamento de 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 Kit de AWS Ferramentas AWS CLI e o Kit de Ferramentas.
-
No VS Code, abra o terminal do VS Code pressionando
ctrl + `(backtick)
. -
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
-
O terminal é atualizado com o status da sua instância do Docker quando o processo é 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:
-
No VS Code, abra o terminal do VS Code pressionando
ctrl + `(backtick)
. -
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]
-
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
-
No VS Code, navegue até a barra de status e escolha o LocalStack botão Iniciar para iniciar LocalStack.
-
A barra de status do VS Code é atualizada quando é LocalStack iniciada com sucesso.
Começando LocalStack pela paleta de comandos do VS Code
-
No VS Code, abra a Paleta de Comandos pressionando
Cmd + Shift + P
(Mac) ouControl + Shift + P
(Windows). -
Na Paleta de Comandos, insira
Start LocalStack
na barra de pesquisa e escolha-a na lista quando ela for preenchida nos resultados. -
A barra de status do VS Code é atualizada quando é LocalStack iniciada com sucesso.
A LocalStack partir do terminal VS Code
-
No VS Code, abra o terminal do VS Code pressionando
ctrl + `(backtick)
. -
No terminal do VS Code, insira o
localstack start
comando CLI. -
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 obter informações adicionais sobre a criação de um aplicativo com o Serverless Land no AWS
kit de ferramentas, consulte o tópico Trabalhando com o AWS Serverless Land 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
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 neste guia do usuário.