Workloads do .NET no AWS Lambda

No Visual Studio, acesse o menu Extensão e selecione Gerenciar extensões. À direita, na caixa de pesquisa, digite “Kit de ferramentas da AWS”. No painel de resultados, selecione a extensão “Kit de ferramentas da AWS para Visual Studio” e clique em Baixar. Siga as instruções para instalar a extensão. Talvez seja necessário reiniciar o Visual Studio.

Em relação ao serviço do Lambda, o kit de ferramentas fornece dois conjuntos principais de atributos, modelos de projeto para funções do Lambda e ferramentas para auxiliar na implantação, gerenciamento e teste/invocação de funções do Lambda. Além disso, o kit de ferramentas permite gerenciar outros recursos da AWS e implantar aplicações em outros tipos de infraestrutura da AWS, como AWS Fargate, AWS App Runner e AWS Elastic Beanstalk (eles não são abordados neste curso).

O kit de ferramentas adiciona vários modelos de projeto do Lambda para ajudar você a criar uma variedade de funções do Lambda.

O mais simples pega uma string e retorna uma versão em maiúscula dessa string. Essa é uma ótima opção para começar, devido à sua simplicidade, facilidade de implantação e de teste. Em apenas alguns minutos, você poderá ter uma função do Lambda em .NET executada na AWS, enviar solicitações e obter respostas.

No lado mais complexo, há um modelo que fornece uma aplicação Web do .NET 6 completo (com páginas da Web e controladores de API). Quando isso for implantado, a infraestrutura necessária para torná-lo acessível pela Web também será implantada e configurada para você.

Há modelos de projetos de contêineres disponíveis, se essa for sua preferência. Observe que você deve ter o Docker instalado em seu computador para que eles funcionem. Consulte a seção “Escolher o runtime para você”, no módulo 4, para saber por que você pode optar por usar imagens de contêiner com funções do Lambda.

O teste de unidade das funções do Lambda é tão importante quanto testar qualquer outro código. A maioria dos modelos de projeto inclui um projeto de teste que usa o xUnit para testar o código no projeto de código-fonte. Isso facilita o início dos testes de unidade.

Como você pode ver acima, no Visual Studio você também pode publicar suas funções no serviço do AWS Lambda. A funcionalidade de publicação se encarrega de criar um pacote, fazer o upload para o serviço do Lambda, aplicar permissões, criar o endpoint do API Gateway e quaisquer outras etapas necessárias para que seu código seja executado e disponibilizado para invocação. Tudo o que você precisa fazer é escrever o código.

Outro atributo do kit de ferramentas é o AWS Explorer, que permite visualizar e gerenciar muitos dos seus recursos da AWS, como DynamoDB, S3, SNS, filas SQS, EC2 e, é claro, funções do Lambda.

Para abrir o AWS Explorer, acesse o menu Exibir e selecione AWS Explorer.

Em relação às funções do Lambda, o AWS Explorer permite que você:

• Escolha uma região.
• Visualize e gerencie as funções do Lambda.
• Invoque funções do Lambda na AWS, transmitindo todos os parâmetros necessários e visualize a resposta. As ferramentas fornecem amostras de entrada para simular chamadas de vários outros serviços da AWS. Isso é muito útil quando você estiver criando uma função do Lambda que seja acionada por um evento de algum outro serviço, por exemplo, um arquivo sendo criado no S3.
• Depure uma versão executada localmente de uma função do Lambda.
• Configure serviços que tenham permissão para acionar uma função do Lambda.
• Visualize os logs gerados pelas funções do Lambda.
  

Para invocar uma função do Lambda no kit de ferramentas, abra o AWS Explorer, expanda a seção Lambda, clique com o botão direito na função do Lambda que você deseja executar e selecione Exibir função.

Ali você pode escolher uma solicitação de exemplo na lista suspensa. Esses exemplos permitem simular chamadas de outros serviços da AWS, como API Gateway, S3, SNS etc. Isso permite que você teste de forma fácil e direta as funções do Lambda que são invocadas por eventos de outros serviços.

Você também pode usar sua própria solicitação.

Além disso, todas as ferramentas de linha de comando relacionadas ao Lambda podem ser usadas por meio do terminal.

Se você é novo na AWS, o kit de ferramentas para Visual Studio é a melhor maneira de começar. Ele tem o maior número de atributos de todos os kits de ferramentas disponíveis e é o mais fácil de depurar e fazer implantações. O kit de ferramentas da AWS para Visual Studio também funciona com o Visual Studio Community Edition, que está disponível gratuitamente. Isso, junto com o nível gratuito na AWS, é uma ótima combinação para desenvolvedores que forem novos na AWS.

Para instalar o kit de ferramentas da AWS para Rider, abra o menu Arquivo, depois Configurações e Plugins. Procure pelo o kit de ferramentas da AWS e instale-o.

Se você já configurou uma conta da AWS em seu computador, o kit de ferramentas se conectará automaticamente à sua conta da AWS.

Depois de instalado, você terá uma variedade de novos modelos da função do AWS Lambda disponíveis.

A CLI da AWS está disponível para Windows, Linux e Mac. Seu método de instalação variará dependendo do sistema operacional. As instruções completas podem ser encontradas na página da AWS, Instalar ou atualizar a versão mais recente da CLI da AWS. A AWS desaconselha a instalação da CLI da AWS usando qualquer software de gerenciamento de pacotes. Em vez disso, use o link fornecido acima.

Lembre-se de que você precisa atualizar a CLI da AWS de tempos em tempos para obter os atributos mais recentes.

Para verificar sua versão da CLI da AWS, execute o seguinte comando:

Você verá uma resposta semelhante a esta:

Isso me informa que a versão 2.5.4 da CLI da AWS está instalada.

Para ver qual é a versão mais recente da CLI da AWS, acesse https://github.com/aws/aws-cli/blob/v2/CHANGELOG.rst. Abaixo de “CHANGELOG” estará a versão mais recente. No momento em que este artigo foi escrito, é 2.7.2, então preciso atualizar minha CLI da AWS!

Com a CLI da AWS, você pode gerenciar todos os seus recursos da AWS. A CLI da AWS inclui recursos poderosos de consulta e filtragem, que podem ajudar você a encontrar os recursos que você está procurando. Como esperado, a CLI da AWS permite listar, visualizar, gerenciar e invocar funções do Lambda.

Uma extensa documentação com exemplos está disponível na Referência de comando da CLI da AWS.

Para instalar os modelos, execute o seguinte comando:

Após a conclusão da instalação, você usará o novo comando dotnet para criar novos projetos para a função do Lambda.

Para ver a lista de modelos de projeto disponíveis, execute o seguinte comando:

Você verá uma saída parecida com esta (observe que os modelos disponíveis mudam periodicamente):

Você pode notar que o nome abreviado de alguns modelos começa com “sem servidor” e alguns começam com “lambda.”

Aqueles que começam com “sem servidor” usam o AWS Serverless Application Model (SAM) para implantar a função do Lambda e criar a infraestrutura necessária que a função do Lambda usará. O AWS SAM é uma estrutura de código aberto que permite criar aplicações sem servidor na AWS. Além de definir a função do Lambda, com o AWS SAM, você pode definir outros recursos, como gateways de API, bancos de dados e fontes de eventos.

Se você navegar até o diretório projectname/src/projectname, você verá um arquivo chamado serverless.template. Isso define a infraestrutura necessária e como ela está conectada à função do Lambda. Em todos os modelos “sem servidor” listados acima, um API Gateway é usado para rotear as solicitações HTTP para a função do Lambda.

Os modelos que começam com “lambda”. não usam o modelo de aplicação sem servidor e não configuram outra infraestrutura. Se outra infraestrutura for necessária, você mesmo precisará configurá-la. Por exemplo, o modelo de projeto Lambda.kinesis mostra como processar eventos de entrada do Kinesis, mas NÃO cria os streams do Kinesis para você nem adiciona as permissões relevantes necessárias para que o Kinesis acione a função do Lambda.

Para criar um novo projeto com base no modelo lambda.EmptyFunction, execute:

As ferramentas são de código aberto e estão disponíveis para visualização no GitHub,

https://github.com/aws/aws-lambda-dotnet#dotnet-cli-templates.

Assim como nas outras ferramentas de linha de comando, você deve ficar de olho nas páginas relevantes do GitHub para ver quando novas versões forem lançadas.

Para instalar a extensão da CLI da AWS para .NET, execute o seguinte:

Para verificar se ele está instalado corretamente, execute:

Isso exibirá um resumo dos comandos que você pode usar e um número de versão.

Essa ferramenta funciona em qualquer shell e é especialmente útil quando usada no terminal no Visual Studio Code e no Rider. Ela permite que você execute tarefas comuns relacionadas à função do Lambda.

Por exemplo, para listar todas as funções do Lambda, você pode usar:

Ou para invocar uma função do Lambda, execute:

Ela também pode implantar funções do Lambda. Depois de criar uma função do Lambda, com modelos dotnet Lambda (veja acima), você poderá implantar a função na AWS usando -

Isso iniciará um processo de construção e implantação guiada. A ferramenta solicitará o nome da função do Lambda e o perfil a ser atribuído à função (ou criar um novo). Se você criou um novo perfil, será necessário escolher uma política de permissão para ele. Em seguida, a ferramenta implantará a função na AWS e, em alguns segundos, você poderá invocá-la!

Para ver todas as opções de linha de comando disponíveis, use -

Lembre-se de que por trás de cada comando pode haver muitas funcionalidades, por isso é importante entender que cada linha de comando oferece suporte a várias opções. Por exemplo, o update-function-config é onde você ativa e configura os URLs da função do Lambda. Essa funcionalidade não está disponível no comando deploy-function. Manter-se atualizado com a documentação de lançamento e os atributos mais recentes do serviço do Lambda é importante, pois isso ajudará você a entender e usar os atributos mais recentes.

Embora essa ferramenta seja muito prática e poderosa para gerenciar funções do Lambda ao desenvolver código e aprender sobre a AWS, recomendamos fortemente que você use um processo robusto de CI/CD para implantar em suas aplicações quando elas atingirem um determinado nível de maturidade. A AWS oferece suporte a todas as principais ferramentas de CI/CD.

Para instalação no Windows, consulte o guia de instalação das Ferramentas da AWS para PowerShell no Windows.

Para instalação em Linux ou Mac, consulte o guia de instalação das Ferramentas da AWS para PowerShell no Linux ou macOS.

O número de módulos e de comandos que podem ser executados pelas ferramentas da AWS para PowerShell é muito grande. Em relação ao AWS Lambda, você pode usar as ferramentas para listar, visualizar, implantar, gerenciar e invocar funções.

Para ver todos os comandos disponíveis, execute:

Você pode encontrar a documentação completa de todos os comandos na referência de Cmdlet das ferramentas da AWS para PowerShell. Navegue até a seção Lambda na barra esquerda.

Para listar todas as funções do Lambda, execute:

Para invocar uma função do Lambda, execute: