Criando e publicando uma função AWS Lambda com o CLI do .NET Core \| TreinaWeb Promoção no ar Matricule-se agora e garanta **54% de desconto** Termina em Tempo restante da oferta: 17 Horas 36 Min 20 Seg Tempo restante da oferta: 17 36 20 [Assinar →](https://www.treinaweb.com.br/checkout/pagamento/plano/anual?cupom=TW-SCLIENTE26) [ ](https://www.treinaweb.com.br) Explorar [ Quanto custa? ](#assinatura) [ FAQ ](https://www.treinaweb.com.br#faq) [Matricule-se](#assinatura) [ Entrar ](https://www.treinaweb.com.br/login) [ Início ](https://www.treinaweb.com.br) [ Artigos ](https://www.treinaweb.com.br/blog) Criando e publicando uma função AWS Lambda com o CLI do .NET Core [ C# ](https://www.treinaweb.com.br/blog/categoria/csharp) [ .NET Core ](https://www.treinaweb.com.br/blog/categoria/net-core) [ Amazon ](https://www.treinaweb.com.br/blog/categoria/amazon) # Criando e publicando uma função AWS Lambda com o CLI do .NET Core O .NET Core CLI, que já é uma ferramenta poderosa e com recursos fornecidos pela AWS, também permite criar e gerar funções Lambda. [ Wladimilson M. Nascimento ](https://www.treinaweb.com.br/blog/autor/wladimilson-m-nascimento) 6 anos atrás ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2020/08/clicando-publicando-lambda-com-net-core-cli.png) [AWS Lambda](https://www.treinaweb.com.br/blog/o-que-e-aws-lambda/) é um serviço da AWS que nos permite criar aplicações no modelo [serverless](https://www.treinaweb.com.br/blog/serverless-uma-introducao/). Fornecendo suporte para as versões 2.1 e 3.1 do .NET Core, este serviço disponibiliza uma série de ferramentas que permite a criação, publicação e execução de uma função do AWS Lambda pelo CLI do .NET Core. [ ![Amazon Web Services (AWS) - Lambda - Fundamentos](https://d2knvm16wkt3ia.cloudfront.net/assets/svg-icon/aws.svg) Curso Amazon Web Services (AWS) - Lambda - Fundamentos Conhecer o curso ](https://www.treinaweb.com.br/curso/amazon-web-services-aws-lambda-fundamentos) ## .NET Core CLI A interface de linha de comando do .NET Core é uma ferramenta multiplataforma que disponibiliza nativamente recursos para a criação, desenvolvimento, execução e publicações de aplicações .NET Core. Além disso, também permite que terceiros forneçam pacotes [NuGet](https://www.treinaweb.com.br/blog/o-que-e-o-nuget/) que expandem seus recursos. Neste artigo conheceremos os pacotes disponibilizados pela AWS Lambda, que nos permite gerenciar uma função diretamente pela linha de comando desta ferramenta. ## Criando uma função AWS Lambda com CLI do .NET Core Antes de mais nada é importante que tenha o [SDK do .NET Core](https://dotnet.microsoft.com/download) instalado na sua máquina. No momento da criação deste artigo, só há suporte para as versões 2.1 e 3.1 do .NET Core, então é necessário que instale uma dessas versões. Caso já tenha suporte para uma versão superior, opte por ela. Também é importante que tenha uma conta na AWS e o AWS CLI configurado na sua máquina (esta configuração será utilizada para publicar a função Lambda). Você pode ver como fazer isso, no artigo sobre [a instalação e configuração do AWS CLI](https://www.treinaweb.com.br/blog/como-instalar-e-configurar-o-aws-cli/) do [Gabriel](https://www.treinaweb.com.br/blog/author/gabriel-machado/). Para criar uma função Lambda com o CLI do .NET Core, é necessário instalar o pacote `Amazon.Lambda.Templates`, que fornece uma série de templates do AWS Lambda. Esta instalação pode ser realizada com o comando abaixo: ```shell dotnet new --install Amazon.Lambda.Templates ``` Note que ao instalar o pacote já serão listados os templates do AWS Lambda que foram disponibilizados na ferramenta: No nosso caso iremos utilizar o template `lambda.EmptyFunction`, que permite a criação de uma função Lambda vazia: ```shell dotnet new lambda.EmptyFunction --name ExemploFuncaoLambda ``` Este template irá criar um projeto com duas pastas: `src` e `test`; que contém, respectivamente, o projeto da função e o projeto de testes: ![Estrutura do projeto da função Lambda e do projeto de teste, exibido no Visual Studio Code](https://dkrn4sk0rn31v.cloudfront.net/uploads/2020/08/estrutura-projeto-visual-code-funcao-lambda-vazia-.png) Outro arquivo importante é o **aws-lambda-tools-defaults.json**, presente no projeto da função. É nele que se deve informar as configurações do AWS Lambda que a função utilizará. Veremos isso em mais detalhes à frente. ## Desenvolvendo a função AWS Lambda Para este artigo criei uma função simples que retorna o nome da rua de acordo com o cep informado: ```csharp public class Function { private static readonly HttpClient client = new HttpClient(); /// /// A simple function that takes a brazilian zip code and return the street name /// /// /// /// public async Task FunctionHandlerAsync(string input, ILambdaContext context) { if(input != null){ var streamTask = await client.GetStreamAsync($"https://viacep.com.br/ws/{input}/json/"); var endereco = await JsonSerializer.DeserializeAsync(streamTask); return endereco.logradouro; } return "CEP não informado"; } } ``` Assim como o método `Main` do C#, a função Lambda pode ou não ser assíncrona. Neste exemplo estamos definindo uma função assíncrona. Também note o uso da classe `Endereco` que possui a estrutura abaixo: ```csharp public class Endereco { public string logradouro { get; set; } } ``` Como o código da função mudou, é necessário alterar o projeto de teste: ```csharp public class FunctionTest { [Fact] public void TestToUpperFunction() { var function = new Function(); var context = new TestLambdaContext(); var rua = function.FunctionHandlerAsync("01001000", context).Result; Assert.Equal("Praça da Sé", rua); } } ``` Ele pode ser executado para verificar se está tudo certo com a função: Com a função definida, podemos publicá-la no AWS Lambda. ## Publicando a função no AWS Lambda com o CLI do .NET Core Para publicar uma função no AWS Lambda, a primeira coisa que deve ser feita é configurar o arquivo **aws-lambda-tools-defaults.json**: ```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" : "sa-east-1", "configuration": "Release", "framework": "netcoreapp3.1", "function-runtime": "dotnetcore3.1", "function-memory-size": 256, "function-timeout": 30, "function-handler": "ExemploFuncaoLambda::ExemploFuncaoLambda.Function::FunctionHandlerAsync" } ``` Neste arquivo, na opção `profile`, deve ser informado qual credencial configurada com o AWS CLI será utilizada para a publicação da função. Esta credencial precisa ter permissão de criação de funções Lambda. Geralmente se apenas uma credencial estiver configurada, ela receberá o nome de `default`. Nas demais opções temos: - `region`: Região do AWS que a função será publicada; - `configuration`: Tipo de configuração da função, pode ser “Debug” ou “Release”; - `framework`: Framework utilizado para compilar a função; - `function-runtime`: Framework utilizado para executar a função; - `function-memory-size`: Limite de memória utilizada pela função em MB. Deve ser informado um múltiplo de 64. - `function-timeout`: Tempo máximo de execução da função em segundos. Tempo máximo, 15 minutos; - `function-handler`: Caminho da função, segundo o padrão: `Projeto::Namespace.Classe::Metodo`. Já para publicar a função iremos utilizar a [global tool](https://www.treinaweb.com.br/blog/global-tools-no-net-core-2-1/) `Amazon.Lambda.Tools`, que pode ser instalada com o comando abaixo: ```shell dotnet tool install -g Amazon.Lambda.Tools ``` Após a instalação dela, acesse a pasta do projeto da função e execute o comando: ```shell dotnet lambda deploy-function FuncaoExemplo --function-role role ``` No atributo `--function-role` deve ser informado quais permissões a função terá. Isso determinará se ela terá acesso a outros serviços da AWS. Caso não seja informado, as permissões podem ser definidas durante a publicação da função. Como já tenho uma role de teste definida, vou utilizá-la para publicar a função: Se a publicação não apresentou nenhum erro, podemos testar a nossa função. [ ![IA Para Devs - Cursor AI](https://d2knvm16wkt3ia.cloudfront.net/assets/svg-icon/ia-para-devs.svg) Curso IA Para Devs - Cursor AI Conhecer o curso ](https://www.treinaweb.com.br/curso/ia-para-devs-cursor-ai) ## Executando a função no AWS Lambda com o CLI do .NET Core Com a função publicada no Lambda, ela pode ser invocada pelo CLI do .NET Core utilizando a opção `lambda invoke-function`, seguido do nome da função. Por exemplo: ```shell dotnet lambda invoke-function FuncaoExemplo --payload "01001000" ``` Também note o atributo `--payload`, onde pode ser informado os dados que serão passados para a função. Ao executar este comando, a função será chamada e será exibido no terminal o seu retorno: Caso queira excluir a sua função, pode ser utilizado o comando abaixo: ```shell dotnet lambda delete-function FuncaoExemplo ``` Por fim, mesmo que a maioria das opções que vimos aqui estejam disponíveis no AWS CLI, os recursos adicionados no CLI do .NET Core, facilitam e muito o trabalho de quem desenvolve funções Lambda em C#. Se este é o seu caso, também não deixe de dar uma olhada nos demais recursos disponíveis, utilizando o comando `dotnet lambda --help`. É isso por hoje. Você pode ver o código completo da função no meu [Github](https://github.com/wladimilson/ExemploFuncaoLambda). Até a próxima :) - [ #C# ](https://www.treinaweb.com.br/blog/tag/csharp) - [ #AWS ](https://www.treinaweb.com.br/blog/tag/aws) - [ #.NET Core ](https://www.treinaweb.com.br/blog/tag/net-core) - [ #aws lambda ](https://www.treinaweb.com.br/blog/tag/aws-lambda) - [ #AWS CLI ](https://www.treinaweb.com.br/blog/tag/aws-cli) - [ #.NET Core CLI ](https://www.treinaweb.com.br/blog/tag/net-core-cli) Autor ![Wladimilson M. Nascimento](//secure.gravatar.com/avatar/f0dd442f156a3eacd2880e9cd0eafbd1?d=mm) ## Wladimilson M. Nascimento Instrutor, nerd, cinéfilo e desenvolvedor nas horas vagas. Graduado em Ciências da Computação pela Universidade Metodista de São Paulo. [Todos os artigos](https://www.treinaweb.com.br/blog/autor/wladimilson-m-nascimento) ## Continue estudando Transforme leitura em prática com os cursos e formações da TreinaWeb. [Ver cursos](https://www.treinaweb.com.br/cursos) Continue lendo ## Artigos relacionados - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2020/10/deploy-asp-net-core-linux-nginx-400x280.png) [ ASP .NET ](https://www.treinaweb.com.br/blog/categoria/asp-net) 6 anos atrás ## [ Publicando uma aplicação ASP.NET Core no Linux com o Nginx ](https://www.treinaweb.com.br/blog/publicando-uma-aplicacao-asp-net-core-no-linux-com-o-nginx) Veja todo o processo de publicação de deploy de uma aplicação ASP.NET Core no Linux utilizando o Nginx. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2019/02/13190452/php-cloud-400x280.jpg) [ PHP ](https://www.treinaweb.com.br/blog/categoria/php) 7 anos atrás ## [ Aplicação Serverless desenvolvida em PHP usando AWS Lambda ](https://www.treinaweb.com.br/blog/aplicacao-serverless-desenvolvida-em-php-usando-aws-lambda) Veja como fazer o deploy de uma aplicação PHP Serverless no AWS Lambda usando o Bref. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2018/08/07161700/gerenciamento-python-400x280.png) [ Python ](https://www.treinaweb.com.br/blog/categoria/python) 4 anos atrás ## [ Empacotando e publicando pacotes Python no PyPi ](https://www.treinaweb.com.br/blog/empacotando-e-publicando-pacotes-python-no-pypi) Neste artigo iremos aprender como funciona o processo de empacotar e distribuir nossos próprios pacotes Python no PyPi. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2021/03/criando-interfaces-graficas-no-c-com-gtk-400x280.png) [ C ](https://www.treinaweb.com.br/blog/categoria/c) 6 anos atrás ## [ Criando interfaces gráficas no C com GTK ](https://www.treinaweb.com.br/blog/criando-interfaces-graficas-no-c-com-gtk) Aplicações Desktop ainda são muito utilizadas. Neste artigo aprenda como utilizar o GTK para criar interfaces gráficas no C. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2017/07/checklist-de-seguranca-para-autenticacao-400x280.png) [ Segurança da Informação ](https://www.treinaweb.com.br/blog/categoria/seguranca-da-informacao) 9 anos atrás ## [ Checklist de segurança para autenticação ](https://www.treinaweb.com.br/blog/checklist-de-seguranca-para-autenticacao) Cuidar da segurança é um dos pilares para a sustentação de qualquer aplicação na web. Sem o mínimo não é possível nem mesmo garantir uma razoável disponibilidade. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2017/07/13150455/aplicacoes-self-contained-com-o-net-core-400x280.jpg) [ C# ](https://www.treinaweb.com.br/blog/categoria/csharp) 8 anos atrás ## [ ASP.NET Core: Compreendendo AddMvc(), AddMvcCore(), AddControllers(), AddControllersWithViews() e AddRazorPages() ](https://www.treinaweb.com.br/blog/asp-net-core-compreendendo-addmvc-addmvccore-addcontrollers-addcontrollerswithviews-e-addrazorpages) Aprenda quando utilizar os métodos AddMvc(), AddMvcCore(), AddControllers(), AddControllersWithViews() e AddRazorPages() em uma aplicação ASP.NET Core. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2019/08/01172547/NET-CORE-3-400x280.png) [ C# ](https://www.treinaweb.com.br/blog/categoria/csharp) 7 anos atrás ## [ .NET Core 3.0 - Criando tarefas de segundo plano com Worker Service ](https://www.treinaweb.com.br/blog/net-core-3-0-criando-tarefas-de-segundo-plano-com-worker-service) Você já quis criar tarefas em segundo plano com o .NET Core? Na versão 3.0 foi introduzido o template Worker Service que facilita a criação deste tipo de aplicação. Caso tenha passado por uma situação assim, neste artigo mostramos como você pode aproveitar este novo recurso do .NET Core 3.0. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2020/02/02145619/asp-net-heroku-400x280.png) [ ASP .NET ](https://www.treinaweb.com.br/blog/categoria/asp-net) 7 anos atrás ## [ Publicando uma aplicação ASP.NET Core no Heroku ](https://www.treinaweb.com.br/blog/publicando-uma-aplicacao-asp-net-core-no-heroku) Veja neste artigo como publicar uma aplicação ASP.NET Core no Heroku. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2020/01/10162055/asp-net-beanstalk-400x280.png) [ C# ](https://www.treinaweb.com.br/blog/categoria/csharp) 7 anos atrás ## [ Publicando uma aplicação .NET Core 3.0 no AWS Elastic Beanstalk ](https://www.treinaweb.com.br/blog/publicando-uma-aplicacao-net-core-3-0-no-aws-elastic-beanstalk) Nesse artigo vamos aprender como publicar e configurar um projeto desenvolvido em ASP.NET Core 3.0 no Elastic Beanstalk, o serviço do tipo plataforma como serviço da AWS especializado para aplicações web. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2020/08/técnicas-acessibilidade-web-400x280.png) [ Acessibilidade e User Experience (UX) ](https://www.treinaweb.com.br/blog/categoria/acessibilidade-e-user-experience-ux) 6 anos atrás ## [ Técnicas de acessibilidade para deixar o seu site mais inclusivo ](https://www.treinaweb.com.br/blog/tecnicas-de-acessibilidade-para-deixar-o-seu-site-mais-inclusivo) Conheça as principais ferramentas e técnicas de acessibilidade para web. Veja também tipos de dificuldades e deficiências atendidas por elas. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2018/09/27171404/diego-eis-400x280.png) [ Entrevistas ](https://www.treinaweb.com.br/blog/categoria/entrevistas) 8 anos atrás ## [ TW Entrevista 11: Diego Eis ](https://www.treinaweb.com.br/blog/tw-entrevista-11-diego-eis) Fizemos uma série de entrevistas chamada "TW Entrevista". O entrevistado de hoje é o Diego Eis, fundador do Tableless, um dos maiores sites sobre desenvolvimento web do Brasil. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2021/05/code-copy-400x280.png) [ C# ](https://www.treinaweb.com.br/blog/categoria/csharp) 10 anos atrás ## [ Criando repositórios para o NuGet ](https://www.treinaweb.com.br/blog/criando-repositorios-para-o-nuget) Veja algumas importantes dicas sobre a criação de repositórios para o NuGet. Ler artigo ## Um ano de acesso total para você viver de programação. Todos os cursos e formações da TreinaWeb numa única assinatura, com professores que atuam no mercado, suporte direto e certificados. Do primeiro `console.log` ao mercado de trabalho. - **1 ano** de acesso a **todos os cursos** - Cursos novos **toda semana** - Suporte **direto com professores** - Plano de carreira **personalizado** - **Certificados digitais** inclusos - **Aplicativos** para Android e iOS, com **acesso offline** **Garantia incondicional de satisfação** Teste por 7 dias e, se não fizer sentido para você, devolvemos seu dinheiro. ### Acesso completo a todos os cursos e dezenas de Formações. 12 meses Economize R$ 840,00 54% OFF de 12x R$ 129,00 por apenas 12x R$ 59,00 sem juros no cartão de crédito ou R$ 599,00 à vista Oferta termina em **17h 36min 20s** - Acesso imediato e ilimitado durante 1 ano. - Plano de carreira personalizado. - Suporte direto com professores. - E muito mais! [Matricule-se agora](https://www.treinaweb.com.br/checkout/pagamento/plano/anual?cupom=TW-SCLIENTE26) [ ](https://www.treinaweb.com.br) Escola online de programação, tecnologia e IA. - [ ](https://www.facebook.com/TreinaWeb/) - [ ](https://www.instagram.com/treinaweb/) - [ ](https://www.youtube.com/user/TreinaWeb) - [ ](https://twitter.com/treinaweb) - [ ](https://www.linkedin.com/company/treinaweb) - [ ](https://github.com/treinaweb) ## Inscreva-se em nossa newsletter Receba lançamentos, promoções e novidades. Seu nome Seu WhatsApp Seu melhor e-mail Inscrever-se ## Cursos - [ Base para Devs ](https://www.treinaweb.com.br/categoria/base-para-devs) - [ Front-end ](https://www.treinaweb.com.br/categoria/desenvolvimento-front-end) - [ Back-end ](https://www.treinaweb.com.br/categoria/desenvolvimento-back-end) - [ Mobile ](https://www.treinaweb.com.br/categoria/desenvolvimento-mobile) - [ Bancos de Dados ](https://www.treinaweb.com.br/categoria/bancos-de-dados) - [ Cloud ](https://www.treinaweb.com.br/categoria/cloud-computing) - [ IA ](https://www.treinaweb.com.br/categoria/ia) - [ E mais ](https://www.treinaweb.com.br/categoria/e-mais) - [ Ver todos os cursos ](https://www.treinaweb.com.br/cursos) ## Conteúdo - [ Formações ](https://www.treinaweb.com.br/formacoes) - [ Projetos práticos ](https://www.treinaweb.com.br/projetos-praticos) - [ Direto ao ponto ](https://www.treinaweb.com.br/direto-ao-ponto) - [ Planos ](https://www.treinaweb.com.br#assinatura) - [ Depoimentos ](https://www.treinaweb.com.br#depoimentos) - [ Comunidade ](https://www.treinaweb.com.br#comunidade) - [ Corpo docente ](https://www.treinaweb.com.br#docente) ## A empresa - [ Sobre a TreinaWeb ](https://www.treinaweb.com.br#sobre) - [ Perguntas frequentes ](https://www.treinaweb.com.br#faq) - [ Vantagens de estudar na TreinaWeb ](https://www.treinaweb.com.br/vantagens-de-estudar-na-treinaweb) - [ Cursos para empresas ](https://www.treinaweb.com.br/empresas) - [ Sugira um novo curso ](https://www.treinaweb.com.br/sugerir-curso) - [ Trabalhe conosco ](https://www.treinaweb.com.br/trabalhe-conosco) - [ Artigos ](https://www.treinaweb.com.br/blog) - [ Desenvolvedores e agentes ](https://www.treinaweb.com.br/developers) - [ Contato ](https://www.treinaweb.com.br/contato) - [ Política de privacidade ](https://www.treinaweb.com.br/politica-de-privacidade) - [ Termos de uso ](https://www.treinaweb.com.br/termos-de-uso) ## Baixe nosso aplicativo [ Disponível na **App Store** ](https://apps.apple.com/us/app/treinaweb/id1322729447) [ Disponível no **Google Play** ](https://play.google.com/store/apps/details?id=br.com.treinaweb.mobile) Av. Paulista, 1765, Conj 71 e 72 · Bela Vista · São Paulo · SP · 01311-200 © 2004 – 2026 TreinaWeb Tecnologia LTDA · CNPJ 06.156.637/0001-58