aws lambda dotnet

其他类别 2025-08-06

aws lambda for .net

AWS Nuget软件包和蓝图的存储库支持使用.NET Core编写AWS lambda函数。

有关版本的历史记录查看版本更改日志

目录

  • AWS lambda用于.net核心
    • 目录
    • Nuget软件包
      • 事件
      • Amazon.lambda.tools
        • 全局工具迁移
          • 从dotnetClitoolReference迁移
      • Amazon.lambda.Annotations
      • Amazon.lambda.aspnetcoreserver
      • Amazon.lambda.testutilitys
    • 蓝图
      • Dotnet CLI模板
      • yeoman(弃用)
    • 得到帮助
    • 反馈和贡献

Nuget软件包

此存储库包含许多不同的工具和库,以支持使用.NET的Lambda函数的开发。这些软件包具有单独的读数文档,概述了该特定软件包的特定信息。这些软件包在这里已分类。

事件

此文件夹中的该软件包包含可以用作处理各种AWS事件的lambda函数的输入类型的类。

这些是软件包及其readme.md文件:

  • Amazon.lambda.apigatewayevents -readme.md
  • Amazon.lambda.ApplicationLoadBalanceRevents -readme.md
  • Amazon.lambda.CloudWatchLogSevents -readme.md
  • Amazon.lambda.CognitoEvents -readme.md
  • Amazon.lambda.configevents -readme.md
  • Amazon.lambda.dynamodbevents -readme.md
  • Amazon.lambda.lexevents -readme.md
  • Amazon.lambda.kinesisanalyticsevents -readme.md
  • Amazon.lambda.kinesisevents -readme.md
  • Amazon.lambda.kinesisfirehoseevents -readme.md
  • Amazon.lambda.s3events -readme.md
  • Amazon.lambda.simpleemailevents -readme.md
  • Amazon.lambda.snSevents -readme.md
  • Amazon.lambda.sqsevents -readme.md
  • Amazon.lambda.kafkaevents -readme.md
  • Amazon.lambda.Appsyncevents -readme.md

Amazon.lambda.tools

软件包将命令添加到Dotnet CLI中,可用于管理Lambda功能,包括从Dotnet CLI部署功能。有关更多信息,请参见Amazon.lambda.tools的readme.md文件。

全局工具迁移

截至2018年9月10日,Amazon.lambda.tools已迁移为.NET核心全球工具。作为迁移的一部分,版本号设置为3.0.0.0

安装Amazon.lambda.tools使用dotnet工具安装命令。

dotnet tool install -g Amazon.Lambda.Tools

要更新到最新版本的Amazon.lambda.tools使用dotnet工具update命令。

dotnet tool update -g Amazon.Lambda.Tools
从dotnetClitoolReference迁移

要将现有项目迁移到旧的项目工具中,您需要编辑项目文件并删除Amazon.lambda.tools软件包的dotnetClitoolReference 。例如,让我们看一下现有的lambda项目文件。

netcoreapp2.1 true <-- The new property indicating to AWS Toolkit for Visual Studio this is a Lambda project --> Lambda <-- This line needs to be removed --> ">
< Project Sdk = " Microsoft.NET.Sdk " >
  < PropertyGroup >
    < TargetFramework >netcoreapp2.1TargetFramework >
    < GenerateRuntimeConfigurationFiles >trueGenerateRuntimeConfigurationFiles >

    < -- The new property indicating to AWS Toolkit for Visual Studio this is a Lambda project -->
    < AWSProjectType >LambdaAWSProjectType >
  PropertyGroup >
  
  < ItemGroup >
    < -- This line needs to be removed -->
    < DotNetCliToolReference Include = " Amazon.Lambda.Tools " Version = " 2.2.0 " />
  ItemGroup >

  < ItemGroup >
    < PackageReference Include = " Amazon.Lambda.Core " Version = " 1.0.0 " />
    < PackageReference Include = " Amazon.Lambda.Serialization.Json " Version = " 2.1.0 " />
  ItemGroup >
Project >

要迁移该项目,您需要删除包括Amazon.lambda.tools在内的DotNetClitoolReference元素。如果您不删除此行,则将使用Amazon.lambda.tools的旧项目工具版本,而不是安装的全局工具。

.NET Core 2.1之前的Visual Studio的AWS工具包将在项目文件中寻找Amazon.lambda.tools的存在,以确定是否显示Lambda部署菜单项。因为我们知道我们将切换到全局工具,并且对项目中的Amazon.lambda.tool的引用正在消失,所以我们将AWSProjectType属性添加到了项目文件中。当前版本的Visual Studio AWS工具包现在寻找Amazon.lambda.tools的存在或设置为LambdaAWSprojectType 。确保在删除dotnetClitoolReference时,您的项目文件具有AWSprojectType属性,可以继续使用AWS工具包进行Visual Studio。

Amazon.lambda.Annotations

lambda注释库允许C#函数使用.NET属性,以撰写更惯用的经验,编写lambda函数。这包括依赖注入集成,简化对Lambda事件信息的访问以及与云形式模板的自动同步。有关更多信息,请参见Amazon.lambda.annotations的readme.md文件。

Amazon.lambda.aspnetcoreserver

软件包使运行ASP.NET Core Web API应用程序作为lambda函数变得容易。有关更多信息,请参见Amazon.lambda.aspnetcoreserver的readme.md文件。

Amazon.lambda.testutilitys

软件包包括从Amazon.lambda.Core和帮助助手方法的测试实现,以帮助本地测试。有关更多信息,请参见Amazon.lambda.testutilitys的readme.md文件。

蓝图

此存储库中的蓝图是可以用来开始的.NET Core Lambda函数。在Visual Studio中,创建新项目并选择AWS Lambda项目时可用蓝图。

Dotnet CLI模板

可以使用dotnet new命令创建新的.NET核心项目。通过安装Amazon.lambda.templates Nuget软件包,AWS LAMDBA蓝图可以从dotnet new Command创建。要安装模板执行以下命令:

dotnet new -i "Amazon.Lambda.Templates::*"

::*在命令的末尾指示了Nuget软件包的最新版本。

要查看lambda模板的列表执行dotnet新列表-author aws

> dotnet new list --author AWS              

Template Name                                                                         Short Name                                    Language  Tags                 
------------------------------------------------------------------------------------  --------------------------------------------  --------  ---------------------
Empty Top-level Function                                                              lambda.EmptyTopLevelFunction                  [C#]      AWS/Lambda/Serverless

Lambda Annotations Framework (Preview)                                                serverless.Annotations                        [C#]      AWS/Lambda/Serverless

Lambda ASP.NET Core Minimal API                                                       serverless.AspNetCoreMinimalAPI               [C#]      AWS/Lambda/Serverless

Lambda ASP.NET Core Web API                                                           serverless.AspNetCoreWebAPI                   [C#],F#   AWS/Lambda/Serverless

Lambda ASP.NET Core Web API (.NET 6 Container Image)                                  serverless.image.AspNetCoreWebAPI             [C#],F#   AWS/Lambda/Serverless

Lambda ASP.NET Core Web Application with Razor Pages                                  serverless.AspNetCoreWebApp                   [C#]      AWS/Lambda/Serverless

Lambda Custom Runtime Function (.NET 7)                                               lambda.CustomRuntimeFunction                  [C#],F#   AWS/Lambda/Function  

Lambda Detect Image Labels                                                            lambda.DetectImageLabels                      [C#],F#   AWS/Lambda/Function

Lambda Empty Function                                                                 lambda.EmptyFunction                          [C#],F#   AWS/Lambda/Function

Lambda Empty Function (.NET 7 Container Image)                                        lambda.image.EmptyFunction                    [C#],F#   AWS/Lambda/Function

Lambda Empty Serverless                                                               serverless.EmptyServerless                    [C#],F#   AWS/Lambda/Serverless

Lambda Empty Serverless (.NET 7 Container Image)                                      serverless.image.EmptyServerless              [C#],F#   AWS/Lambda/Serverless

Lambda Function project configured for deployment using .NET 7's Native AOT feature.  lambda.NativeAOT                              [C#],F#   AWS/Lambda/Function

Lambda Giraffe Web App                                                                serverless.Giraffe                            F#        AWS/Lambda/Serverless

Lambda Simple Application Load Balancer Function                                      lambda.SimpleApplicationLoadBalancerFunction  [C#]      AWS/Lambda/Function

Lambda Simple DynamoDB Function                                                       lambda.DynamoDB                               [C#],F#   AWS/Lambda/Function

Lambda Simple Kinesis Firehose Function                                               lambda.KinesisFirehose                        [C#]      AWS/Lambda/Function

Lambda Simple Kinesis Function                                                        lambda.Kinesis                                [C#],F#   AWS/Lambda/Function

Lambda Simple S3 Function                                                             lambda.S3                                     [C#],F#   AWS/Lambda/Function

Lambda Simple SNS Function                                                            lambda.SNS                                    [C#]      AWS/Lambda/Function

Lambda Simple SQS Function                                                            lambda.SQS                                    [C#]      AWS/Lambda/Function

Lex Book Trip Sample                                                                  lambda.LexBookTripSample                      [C#]      AWS/Lambda/Function

Order Flowers Chatbot Tutorial                                                        lambda.OrderFlowersChatbot                    [C#]      AWS/Lambda/Function

Serverless Detect Image Labels                                                        serverless.DetectImageLabels                  [C#],F#   AWS/Lambda/Serverless

Serverless project configured for deployment using .NET 7's Native AOT feature.       serverless.NativeAOT                          [C#],F#   AWS/Lambda/Serverless

Serverless Simple S3 Function                                                         serverless.S3                                 [C#],F#   AWS/Lambda/Serverless

Serverless WebSocket API                                                              serverless.WebSocketAPI                       [C#]      AWS/Lambda/Serverless

Step Functions Hello World                                                            serverless.StepFunctionsHelloWorld            [C#],F#   AWS/Lambda/Serverless

要获取有关模板的详细信息,您可以使用help命令。

dotnet new lambda.emptyfunction-助长

Template Instantiation Commands for .NET Core CLI.                                                                                          
                                                                                                                                           
Lambda Empty Function (C#)                                                                                                                  
Author: AWS                                                                                                                                 
Options:                                                                                                                                    
  -p|--profile  The AWS credentials profile set in aws-lambda-tools-defaults.json and used as the default profile when interacting with AWS.
                string - Optional                                                                                                           
                                                                                                                                           
  -r|--region   The AWS region set in aws-lambda-tools-defaults.json and used as the default region when interacting with AWS.              
                string - Optional  

这些模板采用两个可选参数来设置配置文件和区域。这些值写入AWS-LAMBDA-TOOLS-DEFAULT.JSON。

要创建功能,请运行以下命令

dotnet new lambda.EmptyFunction --name BlogFunction --profile default --region us-east-2

yeoman(弃用)

Yeoman发电机已被弃用,以支持新的Dotnet新模板。它们不会从较旧的项目中迁移。基于json的项目系统。

得到帮助

要在此存储库中了解有关各种软件包的更多信息,请参考我们的学习资源文档。特别是,请务必阅读官方的Lambda开发人员指南。

如果这些资源不足以回答您的问题或解决您的问题,请随时在此存储库上打开问题。

反馈和贡献

我们欢迎社区对代码库和工具的贡献!如果您想做出贡献,请阅读contruting.md文档(我们的贡献指南),并检查问题并打开拉动请求,以确保您想要贡献的修复/功能尚未开发。

下载源码

通过命令行克隆项目:

git clone https://github.com/aws/aws-lambda-dotnet.git