View a markdown version of this page

Trabalhando com AWS Lambda Funções - AWS Toolkit for VS Code
Pré-requisitosInvocar uma função do LambdaExcluir uma função do LambdaBaixar uma função do LambdaImplantar atualizações para novas funções do LambdaCarregando atualizações para funções do Lambda existentesConvertendo sua função do Lambda em uma AWS SAM project

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á.

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 local do VS Code. Com o AWS Toolkit, 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 Lambda desenvolvedor.

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

nota

Se você já criou funções do Lambda usando o Console de gerenciamento da AWS, pode invocá-las no Toolkit. Além disso, você pode abrir suas funções do Lambda no VS Code a partir do AWS Lambda console, para obter informações adicionais, consulte o AWS Lambda console para IDE tópico neste guia do usuário. Para criar uma nova função do 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 Toolkit.

  • A versão mais recente do AWS Toolkit for Visual Studio Code está 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 ver instruções sobre como criar uma função do Lambda, consulte o tópico Criar sua primeira função do Lambda no Guia do desenvolvedor AWS Lambda .

Invocar uma função do Lambda

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

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

  2. No 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 do Lambda que deseja invocar e escolha Invocar na nuvem ou 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 apagar uma função do Lambda, complete o procedimento a seguir.

Atenção

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

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

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

  3. Right-click a função Lambda que você deseja excluir e escolha Excluir.

  4. Quando solicitado, confirme que deseja excluir a série.

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

Baixar uma função do Lambda

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

nota

Para baixar sua função do 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 do Lambda usando Node.js e tempos de execução do Python.

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

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

  3. Right-click a função Lambda que você deseja baixar e, em seguida, escolha Download.

  4. Sua função Lambda abre no editor do VS Code e é exibida no AWS explorador quando o download é concluído. O AWS Toolkit 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 como usar AWS SAM, consulteExecutar e depurar uma aplicação sem servidor usando um modelo (local).

Implantar 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 de código do VS Code e no AWS Explorer.

Como fazer implantação a partir do editor do VS Code

  1. Abra um arquivo da sua função do Lambda no editor de código 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.

Implantando a partir do AWS Explorer

  1. Abra um arquivo da sua função do Lambda no editor de código 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 do Lambda existentes

O procedimento a seguir descreve como fazer upload de alterações locais feitas em suas funções do Lambda existentes. Esse recurso é compatível com uploads com qualquer tempo de execução compatível com o Lambda.

Atenção

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

  • Atualizar o código dessa maneira não usa a AWS SAM CLI para implantação ou criação de uma pilha CloudFormation

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

Fazer upload de um arquivo .zip

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

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

  3. Right-click a função do Lambda para a qual você deseja enviar suas alterações e, em seguida, escolha Carregar Lambda... para abrir o menu Selecionar tipo de upload.

  4. Escolha Arquivo ZIP para localizar o ZIP Archive em seu diretório local.

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

  6. O status do seu upload é exibido no VS Code e você recebe uma notificação notificado quando o processo de upload é concluído.

Como fazer upload de um diretório sem criar

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

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

  3. Right-click a função do Lambda para a qual você deseja enviar suas alterações e, em seguida, 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 fazer upload do diretório selecionado.

  7. O status do upload é exibido no VS Code e você recebe uma notificação quando o processo de upload for concluído.

Fazer upload de um diretório com uma compilação
nota

Esteja ciente do seguinte:

  • Esse procedimento exige a AWS Serverless Application Model CLI.

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

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

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

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

  3. Right-click a função do Lambda para a qual você deseja enviar suas alterações e, em seguida, 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 do Lambda em uma AWS SAM project

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

Atenção

Atualmente, somente um subconjunto de recursos tem suporte na conversão de uma função do Lambda em um projeto AWS SAM . Para localizar os recursos ausentes após uma conversão, verifique o console do 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 desenvolvedor AWS CloudFormation .

  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 do Lambda, escolha o ícone Converter em aplicativo SAM para navegar no sistema de arquivos local e especificar um local para seu novo projeto AWS SAM .

  5. Depois de especificar um local, o AWS Toolkit começa a converter sua função do 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 um nome de pilha e pressione a tecla Enter para prosseguir.

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