Interagir de forma remota com as funções do Lambda

Ao usar o kit de ferramentas para VS Code, você poderá interagir com funções do AWS Lambda de várias maneiras, conforme descrito posteriormente neste tópico.

Para obter mais informações sobre o Lambda, consulte o Manual do desenvolvedor do AWS Lambda.

nota

Se você já criou funções do Lambda usando o AWS Management Console ou de alguma outra forma, será possível invocá-las no Toolkit. Para criar uma função (usando o VS Code) que possa ser implantada no AWS Lambda, você deve primeiro criar uma aplicação sem servidor.

Pré-requisitos

• Verifique se o sistema atende aos pré-requisitos especificados em Instalar o kit de ferramenta para VS Code.

• Certifique-se de que as credenciais que você configurou em Autenticação e acesso incluem acesso adequado de leitura/gravação ao serviço do AWS Lambda. Se no AWS Explorer, em Lambda, você vir uma mensagem semelhante a “Error loading Lambda resources" (Erro ao carregar os recursos do Lambda), verifique as permissões anexadas a essas credenciais. As alterações feitas nas permissões levarão alguns minutos para afetar o AWS Explorer no VS Code.

Invocar uma função do Lambda

Você pode invocar uma função do Lambda na AWS usando o kit de ferramentas para VS Code.

1. No AWS Explorer, escolha o nome da função do Lambda que você deseja invocar e abra o menu de contexto.

   

2. Selecione Invocar na AWS.

3. Na janela de invocação, insira a entrada necessária para a função do Lambda. A função do Lambda pode, por exemplo, exigir uma string como entrada, conforme mostrado na caixa de texto.

   

Você verá a saída da função do Lambda da mesma forma que veria em qualquer outro projeto usando o VS Code.

Excluir uma função do Lambda

Você também pode excluir uma função do Lambda usando o mesmo menu de contexto.

Atenção

Não use este procedimento para excluir as funções do Lambda associadas ao AWS CloudFormation (por exemplo, a função do Lambda que foi criada ao criar uma aplicação sem servidor anteriormente neste guia). Essas funções devem ser excluídas por meio da pilha do AWS CloudFormation.

1. No AWS Explorer, escolha o nome da função do Lambda que você deseja excluir e abra o menu de contexto.

   

2. Escolha Delete (Excluir).

3. Na mensagem exibida, escolha Yes (Sim) para confirmar a exclusão.

   

Depois de excluída, a função deixa de ser listada no AWS Explorer.

Importar uma função do Lambda

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

nota

O kit de ferramentas só é compatível com a importação de funções do Lambda usando runtimes Node.js e Python compatíveis.

1. No AWS Explorer, escolha o nome da função do Lambda que você deseja importar e abra o menu de contexto.

2. Escolha Importar...

3. Selecione uma pasta para importar o código do Lambda. Pastas fora do espaço de trabalho atual serão adicionadas ao espaço de trabalho atual.

4. Após o download, o kit de ferramentas adiciona o código ao espaço de trabalho e abre o arquivo que contém o código do manipulador do Lambda. O kit de ferramentas também cria uma configuração de inicialização, que aparece no painel de execução do VS Code para que você possa executar e depurar localmente a função do Lambda usando o AWS Serverless Application Model. Para obter mais informações sobre o uso de AWS SAM, consulte Executar e depurar uma aplicação sem servidor usando um modelo (local).

Carregar uma função do Lambda

Você pode atualizar funções existentes do Lambda com código local. A atualização do código dessa forma não usa a função AWS SAM CLI para implantação e não cria uma pilha do AWS CloudFormation. Essa funcionalidade pode carregar uma função do Lambda com qualquer tempo de execução compatível com o Lambda.

Atenção

O kit de ferramentas não pode verificar se o código funciona. Verifique se o código funciona antes de atualizar a produção de funções do Lambda.

1. No AWS Explorer, escolha o nome da função do Lambda que você deseja importar e abra o menu de contexto.

2. Selecione Upload Lambda... (Fazer upload do Lambda...)

3. Escolha entre as três opções para fazer o upload da função do Lambda. As opções incluem:

   Carregar um arquivo .zip pré-criado

   • Selecione Arquivo ZIP no menu.

   • Escolha um arquivo .zip do sistema de arquivos e confirme o upload na caixa de diálogo modal. Isso carrega o arquivo .zip no estado em que se encontra e atualiza imediatamente o Lambda após a implantação.

   Carregar um diretório como está

   • Selecione Diretório no menu Seleção rápida.

   • Selecione um diretório no sistema de arquivos.

   • Selecione Não na solicitação para criar o diretório e confirme o upload com a caixa de diálogo modal. Isso carrega o diretório como está e atualiza imediatamente o Lambda após a implantação.

   Criar e carregar um diretório

   nota

   Isso requer a AWS SAM CLI.

   • Selecione Diretório no menu Seleção rápida.

   • Selecione um diretório no sistema de arquivos.

   • Selecione Sim na solicitação para criar o diretório e confirme o upload com a caixa de diálogo modal. Isso constrói o código no diretório usando o comando AWS SAMCLIsam build e atualiza imediatamente o Lambda após a implantação.

     nota

     O kit de ferramentas avisará se não conseguir detectar um manipulador correspondente antes do upload. Se desejar alterar o manipulador vinculado à função do Lambda, você poderá fazer isso por meio do AWS Management Console ou da AWS CLI.