AWS Cloud9 não está mais disponível para novos clientes. Os clientes atuais do AWS Cloud9 podem continuar usando o serviço normalmente. Saiba mais
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á.
O AWS kit de ferramentas oferece suporte a AWS Lambda
Lambda é um serviço de computação totalmente gerenciado que executa seu código em resposta a eventos gerados pelo código personalizado ou em diversos Serviços da AWS. Eles incluem o Amazon Simple Storage Service (Amazon S3), o Amazon DynamoDB, o Amazon Kinesis, o Amazon Simple Notification Service (Amazon SNS) e o Amazon Cognito.
Importante
Se você quiser criar uma aplicação do Lambda que use os recursos fornecidos pelo Serverless Application Model (SAM), consulte Trabalhando com AWS SAM o uso do AWS kit de ferramentas.
Invocar funções do Lambda remotas
Usando o AWS kit de ferramentas, você pode interagir com AWS Lambda
Para obter mais informações sobre o Lambda, consulte o Manual do desenvolvedor do AWS Lambda.
nota
Suponha que você já tenha criado funções Lambda usando o AWS Management Console ou de alguma outra forma. Você pode invocá-los a partir do AWS Toolkit. Para criar uma nova função com o AWS Toolkit na qual você possa implantar AWS Lambda, primeiro você deve criar um aplicativo sem servidor.
Pré-requisitos
-
Certifique-se de que as credenciais que você configurou incluam acesso apropriado de leitura/gravação ao serviço. 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), confira as permissões anexadas a essas credenciais. As alterações realizadas nas permissões levam alguns minutos para afetar o AWS Explorer no Kit de ferramentas da AWS .
Invocar uma função do Lambda
Importante
Chamar métodos de API usando o AWS kit de ferramentas pode resultar em alterações nos recursos que não podem ser desfeitas. Por exemplo, se você chamar um método POST, os recursos da API serão atualizados se a chamada for bem-sucedida.
Você pode invocar uma função Lambda usando AWS o AWS Toolkit.
-
No AWS Explorer, escolha o nome da função do Lambda que você deseja invocar e abra o menu de contexto.
-
Escolha Invocar em. AWS
-
Na janela Invoke function (Chamar função) que se abre, escolha uma opção para a carga útil que a função do Lambda precisa. (A carga útil é o JSON que você quer fornecer para a função Lambda como entrada). É possível selecionar Browse (Procurar) para selecionar um arquivo a ser usado como carga útil ou usar o campo suspenso para escolher um modelo para a carga útil. Nesse caso, a função do Lambda pode parecer uma string como uma entrada, conforme mostrado na caixa de texto.
Selecione Invoke (Invocar) para chamar o Lambda e passar a carga útil.
Você vê a saída da função Lambda na AWS Lambda guia.
Baixar, fazer upload e excluir funções do Lambda
O AWS kit de ferramentas fornece as opções para importar e carregar funções Lambda no IDE. AWS Cloud9
Baixar uma função do Lambda
Ao baixar uma função Lambda, você também baixa os arquivos do projeto que descrevem a função da AWS nuvem e trabalha com eles no AWS Cloud9 IDE.
Para baixar uma função do Lambda
-
No AWS Explorer, no nó do Lambda, abra o menu de contexto (clique com o botão direito do mouse) da função e selecione Download (Baixar).
-
Quando solicitado a Selecionar uma pasta do espaço de trabalho para o novo projeto, você pode executar uma das seguintes ações:
-
Selecione a pasta sugerida para criar uma subpasta com o mesmo nome do projeto do Lambda.
-
Selecione Select a different folder (Selecionar uma pasta diferente) para abrir uma caixa de diálogo para procurar e selecione uma pasta pai diferente como a subpasta do projeto.
O IDE abre uma nova janela do editor.
-
Configurar uma função do Lambda baixada para execução e depuração
Para executar e depurar a função do Lambda baixada como uma aplicação com tecnologia sem servidor, você precisa definir uma configuração de execução no arquivo launch.json. Uma função Lambda que foi criada no AWS Management Console pode não estar incluída em uma configuração de inicialização. Por isso, pode ser necessário adicioná-lo manualmente.
Para adicionar a função do Lambda a fim de iniciar a configuração de execução
-
Depois de baixar a função do Lambda, abra a janela Environment (Ambiente) para exibir suas pastas e arquivos.
-
Depois, verifique se a função do Lambda está incluída em um arquivo
/home/ec2-user/.c9/launch.json. Se ele não estiver presente, faça o seguinte para adicionar um CodeLens link ao código da sua função:Abra o arquivo de código-fonte que define a função do Lambda (por exemplo, um arquivo
.jsou.py). Em seguida, verifique se há um CodeLens link que você possa usar para adicionar sua função lambda a umlaunch.jsonarquivo. A CodeLens aparece acima da função e inclui oAdd Debug Configlink.-
Selecione Go (Ir) (o ícone de lupa) à esquerda do IDE e digite “sam hint” para exibir o comando
AWS: Toggle SAM hints in source files. Escolha o comando a ser executado. Feche o arquivo de código-fonte do Lambda e depois reabra-o.
-
Se o CodeLens estiver disponível no código-fonte depois de reabrir o arquivo, escolha adicionar
Add Debug Configa configuração de inicialização.
Se você não conseguir adicionar um CodeLens mesmo depois de alternar a opção de dica do SAM, faça o seguinte para adicionar a configuração de inicialização:
-
Selecione Go (Ir) (o ícone de lupa) à esquerda do IDE e digite “config” para exibir o comando
AWS: SAM Debug Configuration Editor. Escolha o comando a ser executado. -
O SAM Debug Configuration Editor é exibido. Você pode usar esse editor para definir as propriedades de configuração de ativação. Para obter mais informações, consulte a etapa de configuring launch properties em Usar modelos SAM para executar e depurar aplicações sem servidor.
nota
Se a função do Lambda não tiver um
template.yamlpara aplicações SAM, você precisará adicionar um. Para obter mais informações, consulte Criar o modelo do AWS SAM. -
Depois de terminar de inserir as informações de configuração necessárias no editor, a configuração de execução será adicionada ao arquivo launch.json.
-
Depois de definir uma configuração de execução para a função do Lambda, você poderá executá-la fazendo o seguinte:
Na parte superior do IDE, escolha a seta ao lado de Auto (Automático) e selecione a configuração de execução relevante.
Depois, escolha Run (Executar).
Fazer upload de uma função do Lambda
Você pode atualizar funções existentes do Lambda com código local. Atualizar o código dessa forma não usa a AWS Serverless Application Model CLI para implantação e não cria uma AWS CloudFormation pilha. Dessa forma, é possível fazer upload de uma função do Lambda com qualquer ambiente de tempo de execução compatível com o Lambda.
Há várias opções de interface para carregar funções do Lambda usando AWS o Toolkit.
-
Na janela Environment (Ambiente) referente a seus arquivos de projeto, selecione o menu de contexto (clique com o botão direito do mouse) do
template.yamlpara a aplicação Lambda da qual você deseja fazer upload e selecione Upload Lambda (Fazer upload do Lambda).Se preferir, pressione Ctrl+P para abrir o painel Go to Anything (Acessar tudo) e digite “lambda” para acessar o comando AWS Upload Lambda. Depois, selecione-o para iniciar o processo de upload.
-
Em seguida, selecione um para Região da AWS o qual você deseja fazer o upload.
-
Agora escolha uma opção para carregar a função do Lambda:
Fazer upload de um arquivo .zip
-
Selecione ZIP Archive (Arquivo ZIP) no menu.
-
Escolha um arquivo.zip do seu sistema de AWS Cloud9 arquivos e escolha Abrir.
Carregar um diretório como está
-
Selecione Directory (Diretório) no menu.
-
Escolha um diretório do seu sistema de AWS Cloud9 arquivos e escolha Abrir.
-
Especifique o manipulador de funções do Lambda que processa eventos. Quando sua função é invocada, o Lambda executa esse método do manipulador.
nota
É possível selecionar sua função do Lambda na lista exibida. Se você não souber qual função selecionar, poderá inserir o ARN (nome do recurso da Amazon) de uma função do Lambda disponível no Kit de ferramentas.
Uma caixa de diálogo é exibida perguntando se você deseja que esse código seja publicado como a versão mais recente da função do Lambda. Selecione Yes (Sim) para confirmar a publicação.
nota
Você também pode fazer upload de aplicações Lambda por meio do menu de contexto (clique com o botão direito do mouse) da pasta principal e selecionando Upload Lambda (Fazer upload do Lambda). A pasta principal é selecionada automaticamente para upload.
-
No AWS Explorer, abra o menu de contexto (clique com o botão direito do mouse) do nome da função do Lambda que você deseja importar.
-
Escolha Upload Lambda (Carregar Lambda)
-
Escolha entre as três opções para fazer o upload da função do Lambda.
Carregar um arquivo .zip pré-criado
-
Selecione ZIP Archive (Arquivo ZIP) no menu.
-
Escolha um arquivo.zip do seu sistema de AWS Cloud9 arquivos e escolha Abrir.
-
Confirme o upload com a caixa de diálogo modal. Isso carrega o arquivo.zip e atualiza imediatamente o Lambda após a implantação.
Carregar um diretório como está
-
Selecione Directory (Diretório) no menu.
-
Escolha um diretório do seu sistema de AWS Cloud9 arquivos e escolha Abrir.
-
Selecione No (Não) quando for solicitado a compilar o diretório.
-
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
-
Selecione Directory (Diretório) no menu.
-
Escolha um diretório do seu sistema de AWS Cloud9 arquivos e escolha Abrir.
-
Selecione Yes (Sim) quando for solicitado a compilar o diretório.
-
Confirme o upload com a caixa de diálogo modal. Isso cria o código no diretório usando o comando AWS SAM
sam buildCLI e atualiza imediatamente o Lambda após a implantação.
-
Implantar uma função do Lambda para acesso remoto
Você pode disponibilizar suas funções locais remotamente implantando-as como aplicações SAM sem servidor.
Para implantar uma função do Lambda como uma aplicação SAM
-
No AWS Explorer, abra o menu de contexto (clique com o botão direito do mouse) do nó do Lambda e selecione Deploy SAM Application (Implantar aplicação SAM).
-
No painel de comando, selecione a opção YAML template (Modelo da YAML) que define a função como uma aplicação sem servidor.
-
Depois, selecione um bucket do Amazon S3 para a implantação do Lambda. Você também pode optar por criar um bucket para a implantação.
-
Agora, insira o nome de uma AWS CloudFormation pilha na qual você está implantando. Se você especificar uma pilha existente, o comando atualizará a pilha. Se você especificar uma nova pilha, o comando a criará.
Depois de inserir o nome da pilha, a função do Lambda começará a ser implantada como uma aplicação SAM. Depois de uma implantação bem-sucedida, a aplicação SAM Lambda fica disponível remotamente. Dessa forma, você pode baixá-lo ou invocá-lo de outros ambientes de AWS Cloud9 desenvolvimento.
Se você quiser criar uma função do Lambda a partir do zero, recomendamos seguir as etapas para Crie uma aplicação sem servidor com o AWS Toolkit.
Excluir uma função do Lambda
Você também pode excluir uma função do Lambda usando o mesmo menu de contexto (clique com o botão direito do mouse).
Atenção
Não use esse procedimento para excluir funções do Lambda associadas ao AWS CloudFormation. Por exemplo, não exclua a função do Lambda que foi criada ao criar uma aplicação com tecnologia sem servidor anteriormente, neste guia. Essas funções devem ser excluídas por meio da pilha do AWS CloudFormation .
-
No AWS Explorer, selecione o nome da função do Lambda que você deseja excluir e, depois, abra o menu de contexto (clique com o botão direito do mouse).
-
Escolha Excluir.
-
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.
