Trabalhando com AWS Lambda funções

AWS Toolkit for Visual Studio Code Isso permite que você trabalhe com suas AWS Lambda funções em seu ambiente VS Code local. Com o AWS kit de ferramentas, você pode criar, editar, testar, depurar e implantar suas funções do Lambda sem precisar sair do IDE. Para obter informações detalhadas sobre o AWS Lambda serviço, consulte o Guia do AWS Lambdadesenvolvedor.

As seções a seguir descrevem como começar a trabalhar com funções Lambda no. AWS Toolkit for Visual Studio Code

nota

Se você já criou funções Lambda usando o AWS Management Console, então você pode invocá-las a partir do Toolkit. Além disso, você pode abrir suas funções do Lambda no VS Code a AWS Lambda console partir do. Para obter informações adicionais, consulte o AWS Lambda console tópico do IDE neste guia do usuário. Para criar uma nova função Lambda no VS Code, siga as etapas descritas no tópico Criação de um novo aplicativo sem servidor (local) neste guia do usuário.

Pré-requisitos

As seguintes condições devem ser atendidas para trabalhar com o AWS Lambda serviço no AWS kit de ferramentas.

• A versão mais recente do AWS Toolkit for Visual Studio Code é instalada e configurada com suas AWS credenciais.

• Suas permissões e políticas gerenciadas AWS Identity and Access Management (IAM) estão configuradas para funcionar com o AWS Lambda serviço. Para obter informações detalhadas sobre como configurar suas permissões e criar uma política AWS gerenciada compatível, consulte o AWS Lambda tópico AWS Identity and Access Management for no Guia do AWS Lambda desenvolvedor.

• Você tem AWS Lambda funções existentes ou está familiarizado com a criação de uma. Para obter instruções sobre como criar uma função Lambda, consulte o tópico Criar sua primeira função Lambda no Guia do desenvolvedor.AWS Lambda

Invocando uma função Lambda

Para invocar uma função Lambda da AWS sua conta no VS Code, conclua as etapas a seguir.

1. A partir do AWS Toolkit for Visual Studio Code, expanda o AWS explorador.

2. Do AWS explorador, expanda o Lambda para visualizar seus recursos do Lambda.

3. Abra o menu de contexto (clique com o botão direito do mouse) da função Lambda que você deseja invocar e escolha Invocar na nuvem ou escolha o ícone Invocar na nuvem para abrir o menu de configuração de invocação remota no VS Code.

4. No menu Configuração de invocação remota, especifique suas configurações de carga útil e adicione qualquer informação adicional necessária para o evento.

   nota

   O primeiro processo de invocação pode começar a ser executado assim que você escolher Invocar na nuvem no AWS explorador. A saída é exibida na guia SAÍDA do terminal VS Code.

5. Escolha o botão Invocação remota para invocar sua função. A saída é exibida na guia SAÍDA do terminal VS Code.

Excluir uma função do Lambda

Para excluir uma função Lambda, conclua o procedimento a seguir.

Atenção

Não use esse procedimento para excluir funções do Lambda associadas ao AWS CloudFormation. Essas funções devem ser excluídas da sua AWS CloudFormation pilha.

1. A partir do AWS Toolkit for Visual Studio Code, expanda o AWS explorador.

2. Do AWS explorador, expanda o Lambda para visualizar seus recursos do Lambda.

3. Clique com o botão direito do mouse na função Lambda que você deseja excluir e escolha Excluir.

4. Quando solicitado, confirme que você deseja excluir sua função.

Depois que a função é excluída, ela não é mais listada no AWS explorador.

Baixar uma função do Lambda

Você pode baixar o código de uma função remota do Lambda em seu espaço de trabalho do VS Code para edição e depuração.

nota

Para baixar sua função Lambda, você deve estar trabalhando em um espaço de trabalho do VS Code com uma pasta acessível e o AWS Toolkit só oferece suporte a esse recurso com funções Lambda usando tempos de execução Node.js e Python.

1. A partir do AWS Toolkit for Visual Studio Code, expanda o AWS explorador.

2. Do AWS explorador, expanda o Lambda para visualizar seus recursos do Lambda.

3. Clique com o botão direito do mouse na função Lambda que você deseja baixar e escolha Baixar.

4. Sua função Lambda é aberta no editor do VS Code e é exibida no AWS explorador quando o download é concluído. O AWS kit de ferramentas também cria uma configuração de inicialização no painel de execução do VS Code, permitindo que você execute e depure a função Lambda localmente com. AWS Serverless Application Model Para obter mais informações sobre o uso AWS SAM, consulteExecutar e depurar uma aplicação sem servidor usando um modelo (local).

Implantação de atualizações para novas funções do Lambda

Você pode implantar atualizações para novas funções do Lambda a partir de um local temporário não especificado em sua máquina local.

nota

Quando há alterações não implantadas em seus arquivos lambda, você é notificado pelo ícone M localizado ao lado dos arquivos modificados no editor do VS Code e no explorer. AWS

Implantação a partir do editor VS Code

1. Abra um arquivo da sua função Lambda no editor do VS Code e faça uma alteração no arquivo.

2. Salve manualmente no menu principal do VS Code ou pressione option+s (Mac) ctrl+s (Windows).

3. O VS Code solicita automaticamente que você implante suas alterações na nuvem. Escolha o botão Implantar para confirmar a implantação.

4. O VS Code atualiza você sobre o status da sua implantação e notifica quando o processo é concluído.

Implantação a partir do Explorer AWS

1. Abra um arquivo da sua função Lambda no editor do VS Code e faça uma alteração no arquivo.

2. No AWS Kit de ferramentas, expanda o AWS explorador.

3. No AWS explorador, expanda a AWS região com a função Lambda para a qual você deseja implantar alterações.

4. Na AWS região, expanda o Lambda e navegue pela função para a qual você deseja implantar as alterações.

5. No menu rápido ao lado da sua função, escolha o ícone Salvar e implantar seu código.

6. O VS Code atualiza você sobre o status da sua implantação e notifica quando o processo é concluído.

Carregando atualizações para funções Lambda existentes

Os procedimentos a seguir descrevem como fazer o upload de alterações locais feitas em suas funções existentes do Lambda. Esse recurso suporta uploads com qualquer tempo de execução compatível com o Lambda.

Atenção

Antes de fazer o upload da sua função lambda, esteja ciente do seguinte:

• A atualização do código dessa forma não usa a AWS SAM CLI para implantação ou cria uma pilha AWS CloudFormation

• O AWS kit de ferramentas não valida o código. Valide seu código e teste suas funções antes de enviar qualquer alteração para a nuvem.

Carregando um arquivo Zip

1. A partir do AWS Toolkit for Visual Studio Code, expanda o AWS explorador.

2. Do AWS explorador, expanda o Lambda para visualizar seus recursos do Lambda.

3. Clique com o botão direito do mouse na função Lambda para a qual você deseja fazer o upload das alterações e escolha Carregar Lambda... para abrir o menu Selecionar tipo de upload.

4. Escolha Arquivo ZIP para localizá-lo ZIP Archive em seu diretório local.

5. Quando solicitado, confirme o upload para iniciar o upload do selecionadoZIP Archive.

6. O status do seu upload é exibido no VS Code e você é notificado quando o processo de upload for concluído.

Carregar um diretório sem criar

1. A partir do AWS Toolkit for Visual Studio Code, expanda o AWS explorador.

2. Do AWS explorador, expanda o Lambda para visualizar seus recursos do Lambda.

3. Clique com o botão direito do mouse na função Lambda para a qual você deseja fazer o upload das alterações e escolha Carregar Lambda... para abrir o menu Selecionar tipo de upload.

4. Escolha Diretório para prosseguir até a tela Criar diretório.

5. Na tela Criar diretório, escolha Não para escolher um diretório local para upload.

6. Quando solicitado, confirme o upload para carregar o diretório selecionado.

7. O status do seu upload é exibido no VS Code e você é notificado quando o processo de upload for concluído.

Carregando um diretório com uma compilação

nota

Esteja ciente do seguinte:

• Esse procedimento requer a AWS Serverless Application Model CLI.

• O AWS kit de ferramentas notifica que um manipulador correspondente não pode ser detectado antes do upload.

• Para alterar o manipulador anexado à sua função Lambda, use AWS Lambda console o ou o. AWS Command Line Interface

1. A partir do AWS Toolkit for Visual Studio Code, expanda o AWS explorador.

2. Do AWS explorador, expanda o Lambda para visualizar seus recursos do Lambda.

3. Clique com o botão direito do mouse na função Lambda para a qual você deseja fazer o upload das alterações e escolha Carregar Lambda... para abrir o menu Selecionar tipo de upload.

4. Escolha Diretório para prosseguir até a tela Criar diretório.

5. Na tela Criar diretório, escolha Sim e selecione um diretório local para upload.

6. Quando solicitado, confirme o upload para começar a criar e carregar o diretório selecionado.

7. O status do seu upload é exibido no VS Code e você é notificado quando o processo de upload for concluído.

Convertendo sua função Lambda em um projeto AWS SAM

Para converter sua função Lambda em uma AWS SAM pilha, conclua as etapas a seguir.

Atenção

Atualmente, somente um subconjunto de recursos é suportado na conversão de uma função Lambda em um projeto. AWS SAM Para localizar os recursos ausentes após uma conversão, verifique o console Lambda e adicione-os manualmente ao seu AWS SAM modelo. Para obter detalhes adicionais sobre recursos compatíveis e não suportados, consulte o tópico Suporte ao tipo de recurso no Guia do AWS CloudFormation desenvolvedor.

1. No AWS Kit de ferramentas, expanda o AWS explorador.

2. No AWS explorador, expanda a AWS região com a função Lambda que você deseja converter em um AWS SAM projeto.

3. Na AWS região, expanda o Lambda e navegue pela função que você deseja converter em uma AWS SAM pilha.

4. No menu rápido ao lado da função Lambda, escolha o ícone Converter em aplicativo SAM para navegar pelo sistema de arquivos local e especificar um local para seu novo AWS SAM projeto.

5. Depois de especificar um local em que o AWS Toolkit começa a converter sua função Lambda em um AWS SAM projeto, o VS Code fornece atualizações sobre o status do processo.

   nota

   esse processo pode demorar alguns minutos.

6. Quando solicitado pelo VS Code, insira o nome da pilha e pressione a Enter tecla para continuar.

7. O VS Code continua atualizando você com o status do seu projeto, depois notifica você quando o processo é concluído e abre seu novo AWS SAM projeto como um espaço de trabalho do VS Code.