教程:使用以下方法构建和测试无服务器应用程序 Amazon Lambda - Amazon 适用于 Visual Studio 的工具包
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

教程:使用以下方法构建和测试无服务器应用程序 Amazon Lambda

您可以使用模板构建无服务器 Lambda 应用程序。 Amazon Toolkit for Visual Studio Lambda 项目模板包括一个用于Amazon 无服务器应用程序的模板,即Amazon 无服务器应用程序模型 (S AM) 的 Amazon Toolkit for Visual Studio 实现。Amazon 使用此项目类型,您可以开发一组 Amazon Lambda 函数,并使用任何必要的 Amazon 资源将它们作为整个应用程序进行部署, Amazon CloudFormation 用于协调部署。

有关设置的先决条件和信息 Amazon Toolkit for Visual Studio,请参阅使用 Visual Stu Amazon dio Amazon 工具包中的 Lambda 模板

创建一个新的 Amazon 无服务器应用程序项目

Amazon 无服务器应用程序项目使用无服务器模板创建 Lambda 函数。 Amazon CloudFormation Amazon CloudFormation 模板使您能够定义其他资源,例如数据库、添加 IAM 角色和一次部署多个函数。这与 Amazon Lambda 项目不同,后者侧重于开发和部署单个 Lambda 函数。

以下过程介绍如何创建新的 Amazon 无服务器应用程序项目。

  1. 从 Visual Studio 中展开 “文件” 菜单,展开 “新建”,然后选择 “项目”。

  2. 在 “新建项目” 对话框中,确保将 “语言”、“平台” 和 “项目类型” 下拉框设置为 “全部...”,然后在 “搜索” 字段aws lambda中输入。

  3. 选择带测试的Amazon 无服务器应用程序(.NET Core – C#)模板。

    注意

    带测试的Amazon 无服务器应用程序(.NET Core-C#)模板可能不会填充在结果的顶部。

  4. 单击 “下一步” 打开 “配置您的新项目” 对话框。

  5. 在 “配置您的新项目” 对话框中,输入ServerlessPowertools名称,然后根据自己的喜好填写其余字段。选择 “创建” 按钮进入选择蓝图对话框。

  6. “选择蓝图” 对话框中为 Amazon Lambda蓝图选择 Powertools,然后选择 “完成” 创建 Visual Studio 项目。

查看无服务器应用程序文件

以下各节详细介绍了为您的项目创建的三个无服务器应用程序文件:

  1. serverless.template

  2. Functions.cs

  3. aws-lambda-tools-defaults.json

1. 无服务器.template

serverless.template文件是用于声明您的无服务器函数和其他 Amazon 资源的 Amazon CloudFormation 模板。此项目中包含的文件包含单个 Lambda 函数的声明,该函数将作为一项HTTP *Get*操作通过 Amazon API Gateway 公开。您可以编辑此模板以自定义现有函数或添加应用程序所需的更多函数和其他资源。

以下是 serverless.template 文件的示例:

{ "AWSTemplateFormatVersion": "2010-09-09", "Transform": "AWS::Serverless-2016-10-31", "Description": "An AWS Serverless Application.", "Resources": { "Get": { "Type": "AWS::Serverless::Function", "Properties": { "Architectures": [ "x86_64" ], "Handler": "ServerlessPowertools::ServerlessPowertools.Functions::Get", "Runtime": "dotnet8", "CodeUri": "", "MemorySize": 512, "Timeout": 30, "Role": null, "Policies": [ "AWSLambdaBasicExecutionRole" ], "Environment": { "Variables": { "POWERTOOLS_SERVICE_NAME": "ServerlessGreeting", "POWERTOOLS_LOG_LEVEL": "Info", "POWERTOOLS_LOGGER_CASE": "PascalCase", "POWERTOOLS_TRACER_CAPTURE_RESPONSE": true, "POWERTOOLS_TRACER_CAPTURE_ERROR": true, "POWERTOOLS_METRICS_NAMESPACE": "ServerlessGreeting" } }, "Events": { "RootGet": { "Type": "Api", "Properties": { "Path": "/", "Method": "GET" } } } } } }, "Outputs": { "ApiURL": { "Description": "API endpoint URL for Prod environment", "Value": { "Fn::Sub": "https://${ServerlessRestApi}.execute-api.${AWS::Region}.amazonaws.com/Prod/" } } } }

请注意,许多...AWS:: Serverless::Function...声明字段与 Lambda 项目部署的字段相似。Powertools 日志、指标和跟踪是通过以下环境变量配置的:

  • POWERTOOLS 服务名称= ServerlessGreeting

  • PowerTools_log_level=in

  • POWERTOOLS_LOGGER_C PascalCase

  • PowerTools_tracer_capture_response=T

  • PowerTools_tracer_capture_error=True

  • POWERTOOLS_METRICS_NAMESPAC ServerlessGreeting

有关环境变量的定义和其他详细信息,请参阅 Powertools 供 Amazon Lambda 参考网站。

2. Functions.cs

Functions.cs是一个包含一个 C# 方法的类文件,该方法映射到模板文件中声明的单个函数。Lambda 函数响应 API Gatewa HTTP Get y 中的方法。以下是该Functions.cs文件的示例:

public class Functions { [Logging(LogEvent = true, CorrelationIdPath = CorrelationIdPaths.ApiGatewayRest)] [Metrics(CaptureColdStart = true)] [Tracing(CaptureMode = TracingCaptureMode.ResponseAndError)] public APIGatewayProxyResponse Get(APIGatewayProxyRequest request, ILambdaContext context) { Logger.LogInformation("Get Request"); var greeting = GetGreeting(); var response = new APIGatewayProxyResponse { StatusCode = (int)HttpStatusCode.OK, Body = greeting, Headers = new Dictionary (string, string) { { "Content-Type", "text/plain" } } }; return response; } [Tracing(SegmentName = "GetGreeting Method")] private static string GetGreeting() { Metrics.AddMetric("GetGreeting_Invocations", 1, MetricUnit.Count); return "Hello Powertools for AWS Lambda (.NET)"; } }

3。 aws-lambda-tools-defaults.json

aws-lambda-tools-defaults.json提供了 Visual Studio 内部 Amazon 部署向导的默认值以及添加到.NET Core CLI 中的 Amazon Lambda 命令。以下是此项目中包含的aws-lambda-tools-defaults.json文件的示例:

{ "profile": "Default", "region": "us-east-1", "configuration": "Release", "s3-prefix": "ServerlessPowertools/", "template": "serverless.template", "template-parameters": "" }

部署无服务器应用程序

要部署您的无服务器应用程序,请完成以下步骤

  1. 解决方案资源管理器中,打开项目的快捷菜单(右键单击),然后选择 “发布到 Amazon Lambda” 以打开 “发布 Amazon 无服务器应用程序” 对话框。

  2. 在 “发布 Amazon 无服务器应用程序” 对话框中,在 Amazon CloudFormation 堆栈名称字段中输入堆栈容器的名称

  3. S3 存储桶字段中,选择您的应用程序包将上传到的 Amazon S3 存储桶,或者选择新的... 按钮,然后输入新 Amazon S3 存储桶的名称。然后选择 “发布以发布” 来部署您的应用程序。

    注意

    您的 Amazon CloudFormation 堆栈和 Amazon S3 存储桶必须位于同一 Amazon 区域。项目的其余设置在serverless.template文件中定义。

    “发布 Amazon 无服务器应用程序” 对话框的图像。
  4. 在发布过程中,“堆栈视图” 窗口打开,部署完成后,“状态” 字段将显示:CREATE_COMPLETE

    Visual Studio 中部署堆栈视图窗口的图像。

部署无服务器应用程序

堆栈创建完成后,您可以使用Amazon 无服务器 URL 查看您的应用程序。如果您在完成本教程时未添加任何其他函数或参数,则访问您的 Amazon 无服务器 URL 会在您的网络浏览器中显示以下短语:Hello Powertools for AWS Lambda (.NET)