Projeto básico do AWS Lambda - AWS Kit de ferramentas com Amazon Q
Criar um projeto do Lambda do Visual Studio .NET CoreRevisar os arquivos de projetoPublicar no LambdaLimpeza

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

Projeto básico do AWS Lambda

Você pode criar uma função do Lambda usando modelos de projeto do Microsoft .NET Core, no AWS Toolkit for Visual Studio.

Criar um projeto do Lambda do Visual Studio .NET Core

Você pode usar modelos e esquemas do Lambda no Visual Studio para ajudar a acelerar a inicialização do seu projeto. Os esquemas do Lambda contêm funções pré-escritas que simplificam a criação de uma base de projeto flexível.

nota

O serviço Lambda tem limites de dados para diferentes tipos de pacotes. Para obter informações detalhadas sobre os limites de dados, consulte o tópico Cotas do Lambda no Guia do usuário do AWS Lambda.

Como criar um projeto do Lambda no Visual Studio

  1. No Visual Studio, expanda o menu Arquivo, expanda Novo e selecione Projeto.

  2. Na caixa de diálogo Novo projeto, defina as caixas suspensas Idioma, Plataforma e Tipo de projeto como “Todos” e digite aws lambda no campo Pesquisar. Escolha o modelo Projeto do AWS Lambda (.NET Core - C#).

  3. No campo Nome, insira AWSLambdaSample, especifique o Local do arquivo desejado e clique em Criar para prosseguir.

  4. Na página Selecionar esquema, selecione o esquema Função vazia e clique em Concluir para criar o projeto do Visual Studio.

Revisar os arquivos de projeto

Há dois arquivos de projeto revisar: aws-lambda-tools-defaults.json e Function.cs.

O exemplo a seguir mostra o arquivo aws-lambda-tools-defaults.json, criado automaticamente como parte do projeto. Você pode definir as opções de compilação usando os campos nesse arquivo.

nota

Os modelos de projeto no Visual Studio contêm muitos campos diferentes. Observe o seguinte:

  • function-handler: especifica o método executado quando a função do Lambda é executada.

  • A especificação de um valor no campo function-handler preenche previamente esse valor no assistente de publicação.

  • Se você renomear a função, a classe ou o conjunto, precisará atualizar o campo correspondente no arquivo aws-lambda-tools-defaults.json.

{
  "Information": [
    "This file provides default values for the deployment wizard inside Visual Studio and the AWS Lambda commands added to the .NET Core CLI.",
    "To learn more about the Lambda commands with the .NET Core CLI execute the following command at the command line in the project root directory.",
    "dotnet lambda help",
    "All the command line options for the Lambda command can be specified in this file."
  ],
  "profile": "default",
  "region": "us-west-2",
  "configuration": "Release",
  "function-architecture": "x86_64",
  "function-runtime": "dotnet8",
  "function-memory-size": 512,
  "function-timeout": 30,
  "function-handler": "AWSLambdaSample::AWSLambdaSample.Function::FunctionHandler"
}

Examine o arquivo Function.cs. O Function.cs define as funções c# a serem expostas como funções do Lambda. Esse FunctionHandler é a funcionalidade do Lambda que é executada quando a função do Lambda é executada. Neste projeto, há uma função definida: FunctionHandler, que chama ToUpper() no texto de entrada.

O projeto já está pronto para ser publicado no Lambda.

Publicar no Lambda

O procedimento e a imagem a seguir demonstram como fazer upload de uma função no Lambda usando o AWS Toolkit for Visual Studio.

Invocação da página da função de teste
Publicar uma função no Lambda

  1. Navegue até o AWS Explorer expandindo Exibir e selecionando AWS Explorer.

  2. No Explorador de soluções, abra o menu de contexto (clique com o botão direito do mouse) do projeto que deseja publicar e selecione Publicar no AWS Lambda para abrir a janela Fazer upload de função do Lambda.

  3. Na janela Fazer upload de função do Lambda, preencha os seguintes campos:

    1. Tipo de pacote: escolha Zip. Um arquivo ZIP será criado como resultado do processo de compilação e será carregado no Lambda. Você também pode escolher Image como Tipo de pacote. O Tutorial: Projeto básico do Lambda para criação de imagens do Docker descreve como publicar usando o Tipo de pacote Image.

    2. Runtime do Lambda: escolha o runtime do Lambda no menu suspenso.

    3. Arquitetura: selecione sua opção de arquitetura preferida.

    4. Nome da função: selecione a opção Criar nova função, depois insira um nome de exibição para a instância do Lambda. Esse nome é referenciado pelas visualizações do AWS Explorer e do Console de gerenciamento da AWS.

    5. Manipulador: use este campo para especificar um manipulador de funções. Por exemplo: AWSLambdaSample::AWSLambdaSample.Function::FunctionHandler.

    6. (Opcional) Descrição: insira um texto descritivo que será exibido com a instância no Console de gerenciamento da AWS.

    7. Configuração: escolha a configuração desejada no menu suspenso.

    8. Framework: escolha o framework desejado no menu suspenso.

    9. Salvar configurações: selecione essa caixa para salvar as configurações atuais em aws-lambda-tools-defaults.json como padrão para implantações futuras.

    10. Clique em Próximo para prosseguir até a janela Detalhes avançados da função.

  4. Na janela Detalhes avançados da função, preencha os seguintes campos:

    1. Nome da função: escolha uma função associada à sua conta. A função é usada para fornecer credenciais para todas as chamadas de serviço da AWS feitas pelo código na função. Se você não tiver uma função, role até Nova função com base na política gerenciada pela AWS no seletor suspenso e selecione AWSLambdaBasicExecutionRole. Essa função tem permissões de acesso mínimas.

      nota

      A conta deve ter permissão para executar a ação ListPolicies do IAM, ou a lista Role Name (Nome da função) estará vazia e você não poderá continuar.

    2. (Opcional) Se a função do Lambda acessar recursos em uma Amazon VPC, selecione as sub-redes e os grupos de segurança.

    3. (Opcional) Defina todas as variáveis de ambiente das quais a função do Lambda precisa. As chaves são criptografadas automaticamente pela chave de serviço padrão, que é gratuita. Você também pode especificar uma chave do AWS KMS, pela qual haverá cobrança. KMS é um serviço gerenciado que você pode usar para criar e controlar chaves de criptografia usadas para criptografar os dados. Se tiver uma chave do AWS KMS, você poderá selecioná-la na lista.

  5. Selecione Fazer upload para abrir a janela Upload da função e iniciar o processo de upload.

    nota

    A página Carregando função é exibida enquanto a função está sendo carregada na AWS. Para manter o assistente aberto após o upload, de maneira que você possa visualizar o relatório, desmarque Fechar o assistente automaticamente após a conclusão bem-sucedida na parte inferior do formulário antes da conclusão do upload.

    Depois que a função for carregada, sua função do Lambda estará ativa. A página Função: é aberta e exibe a configuração da sua nova função do Lambda.

  6. Na guia Função de teste, insira hello lambda! no campo de entrada de texto e selecione Invocar para invocar manualmente a função do Lambda. O texto aparece na guia Resposta, convertido para maiúsculas.

    nota

    Você pode reabrir a visualização Função: a qualquer momento clicando duas vezes na instância implantada, localizada no AWS Explorer abaixo do nó AWS Lambda.

    Invocação da página da função de teste

  7. (Opcional) Para confirmar que você publicou com êxito a função do Lambda, faça login no Console de gerenciamento da AWS e escolha o Lambda. O console exibe todas as funções do Lambda publicadas, incluindo a que você acabou de criar.

Limpeza

Se você não quiser continuar desenvolvendo com este exemplo, exclua a função que implantada para que você não receba cobranças por recursos não utilizados em sua conta.

nota

O Lambda monitora automaticamente as funções do Lambda para você e gera relatórios sobre métricas por meio do Amazon CloudWatch. Para monitorar e solucionar problemas em funções, consulte o tópico Solucionar problemas e monitorar funções do AWS Lambda com o Amazon CloudWatch no Guia do desenvolvedor do AWS Lambda.

Como excluir uma função

  1. No AWS Explorer, expanda o nó AWS Lambda.

  2. Clique com o botão direito do mouse na instância implantada e selecione Excluir.