AWS Lambda 上的 .NET 工作负载

在 Visual Studio 中，转到“扩展”菜单，然后选择“管理扩展”。在右侧的搜索框中，键入“AWS Toolkit”。在结果窗格中，选择“AWS Toolkit for Visual Studio”扩展程序，然后单击下载。按照提示安装扩展程序，您可能需要重新启动 Visual Studio。

关于 Lambda 服务，该工具包提供了两组关键功能、Lambda 函数的项目模板，以及用于协助部署、管理和测试/调用 Lambda 函数的工具。除此之外，该工具包还允许您管理其他 AWS 资源并将应用程序部署到其他类型的 AWS 基础设施，例如 AWS Fargate、AWS App Runner 和 AWS Elastic Beanstalk（本课程不涉及这些内容）。

该工具包添加了许多 Lambda 项目模板，旨在帮助您创建各种 Lambda 函数。

最简单的模板采用一个字符串，并返回该字符串的大写版本。这是个不错的入门模板，因为它简单、易于部署和测试。只需几分钟，您就可以在 AWS 上运行 .NET Lambda 函数，向其发送请求并获得响应。

更复杂的是，有一个模板提供完整的 .NET 6 Web 应用程序（带网页和 API 控制器）。部署该模板之后，还将为您部署和配置所需的基础设施，以便通过 Web 进行访问。

如果您愿意，有容器项目模板可用。请注意，您必须在计算机上安装 Docker 才能使用这些模板。要了解您为什么选择带 Lambda 函数的容器映像，请参阅模块 4 中的“选择适合您的运行时系统”部分。

单元测试您的 Lambda 函数与测试任何其他代码一样重要。大多数项目模板包含测试项目，该项目使用 xUnit 测试源代码项目中的代码。这样的话，您可以轻松开始使用单元测试。

正如上面所述，在 Visual Studio 中，您还可以将您的函数发布到 AWS Lambda 服务。发布功能负责构建软件包、上传到 Lambda 服务、应用权限、创建 API Gateway 端点，以及让代码运行并可供调用的任何其他必要步骤。您只需编写代码即可。

该工具包的另一项功能是 AWS 各区服务浏览器，它允许您查看和管理许多 AWS 资源，例如 DynamoDB、S3、SNS、SQS 队列、EC2，当然还有 Lambda 函数。

要打开 AWS 各区服务浏览器，请转到查看菜单并选择 AWS 各区服务浏览器。

关于 Lambda 函数，AWS 各区服务浏览器允许您：

• 选择一个区域。
• 查看和管理您的 Lambda 函数。
• 在 AWS 上调用 Lambda 函数，传递任何必要的参数，然后查看响应。该工具提供示例输入，用于模拟来自各种其他 AWS 服务的调用。当您构建由其他服务的事件（例如在 S3 上创建的文件）触发的 Lambda 函数时，这非常有用。
• 调试 Lambda 函数的本地运行版本。
• 配置可触发 Lambda 函数的服务。
• 查看由 Lambda 函数生成的日志。
  

要从该工具包中调用 Lambda 函数，请打开 AWS 各区服务浏览器，展开 Lambda 部分，右键单击要执行的 Lambda 函数，然后选择查看函数。

在此处，您可以从下拉列表中选择一个示例请求。 这些示例允许您模拟来自其他 AWS 服务（例如 API Gateway、S3、SNS 等）的调用。这样的话，您可以直接轻松地测试由其他服务的事件调用的 Lambda 函数。

或者，您可以使用自己的请求。

除上述内容外，您可以通过终端使用所有与 Lambda 相关的命令行工具。

如果您刚刚接触 AWS，那么 Toolkit for Visual Studio 是最好的入门方式。它具有所有可用工具包的大多数功能，并且容易调试和执行部署。AWS Toolkit for Visual Studio 还可与免费提供的 Visual Studio 社区版配合使用。对于刚接触 AWS 的开发人员来说，该工具包与 AWS 上的免费套餐是不错的组合。

要安装 AWS Toolkit for Rider，请打开“文件”菜单，然后单击“设置”和“插件”。搜索 AWS Toolkit 并安装。

如果您已经在计算机上配置 AWS 账户，则工具包将自动连接到 AWS。

安装之后，您将有一系列新的 AWS Lambda 函数模板可使用。

AWS CLI 可用于 Windows、Linux 和 Mac。您的安装方法将因操作系统而异。有关完整说明，请参阅 AWS 页面 – 安装或更新最新版本的 AWS CLI。 AWS 不建议使用任何软件包管理软件安装 AWS CLI。而是使用上面提供的链接。

请记住，您必须不时更新 AWS CLI 才能获得最新功能。

要检查您的 AWS CLI 版本，请运行以下命令：

您将看到类似如下的响应：

这说明我已经安装版本 2.5.4 的 AWS CLI。

要查看 AWS CLI 的最新版本是什么，请访问 https://github.com/aws/aws-cli/blob/v2/CHANGELOG.rst，“CHANGELOG”下面就是最新发布的版本。我在写本文时，版本是 2.7.2，因此我需要更新我的 AWS CLI！

借助 AWS CLI，您可以管理您的所有 AWS 资源。AWS CLI 包括强大的查询和筛选功能，可以帮助您找到所需的资源。如您所愿，AWS CLI 允许您列出、查看、管理和调用 Lambda 函数。

AWS CLI 命令参考提供大量包含示例的文档。

要安装模板，请运行以下命令：

安装完成后，您将使用 dotnet new 命令来创建新的 Lambda 函数项目。

要查看可用项目模板的列表，请运行以下命令：

您将看到类似如下的输出（请注意，可用模板会定期更改）：

您可能注意到，一些模板的短名称以“serverless.”开头，还有一些以“lambda.”开头。

以“serverless.”开头的模板使用 AWS Serverless Application Model（SAM）部署 Lambda 函数，并构建 Lambda 函数使用的必要基础设施。AWS SAM 是一个开源框架，允许您在 AWS 上构建无服务器应用程序。除定义 Lambda 函数外，您还可以使用 AWS SAM 定义其他资源，例如 API Gateway、数据库、事件源。

如果您导航到 projectname/src/projectname 目录，您会看到一个名为 serverless.template 的文件。该文件定义了所需的基础设施及其如何连接到 Lambda 函数。在上面列出的所有“serverless.”模板中，API Gateway 用于将 HTTP 请求路由到 Lambda 函数。

以“lambda.”开头的模板不使用 Serverless Application Model，也不设置其他基础设施。如果需要其他基础设施，您需要自己设置。例如，lambda.Kinesis 项目模板向您展示如何处理传入的 Kinesis 事件，但它不会为您创建 Kinesis 流，也不会添加 Kinesis 在触发 Lambda 函数时所需的相关权限。

要基于 lambda.EmptyFunction 模板创建新项目，请运行：

该工具是开源的，可以在 GitHub 上查看，

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

与其他命令行工具一样，您应该密切关注相关的 GitHub 页面，看看新版本何时发布。

要安装 AWS Extensions for .NET CLI，请运行以下命令：

要验证其安装是否正确，请运行：

这将输出您可以使用的命令摘要和版本号。

该工具适用于任何 Shell，从 Visual Studio Code 和 Rider 内的终端使用时尤为有用。它允许您执行与 Lambda 函数相关的常见任务。

例如，要列出所有 Lambda 函数，您可以使用：

或者，要调用 Lambda 函数，请运行：

它还可以部署 Lambda 函数。在使用 dotnet Lambda 模板（见上文）创建 Lambda 函数后，您可以使用以下方法将该函数部署到 AWS：

这将启动构建和引导式部署流程。该工具将要求您提供 Lambda 函数名称、要分配给该函数的角色（或创建新函数）。如果您创建新角色，该工具将要求您为新角色选择权限策略。然后，该工具会将函数部署到 AWS，几秒钟之内您就可以调用它了！

要查看所有可用的命令行选项，请使用：

请记住，每个命令背后可能有很多功能，因此了解每个命令行都支持多个选项，这点很重要。例如，update-function-config 是您启用和配置 Lambda 函数 URL 的地方。该功能不适用于 deploy-function 命令。及时了解 Lambda 服务的最新版本文档和功能，这点非常重要，因为这样将帮助您了解和使用最新功能。

虽然在开发代码和了解 AWS 时，该工具可非常方便地管理 Lambda 函数且功能强大，但我们强烈建议您在应用程序达到一定成熟度时，使用强大的 CI/CD 流程将其部署到应用程序。AWS 支持所有主要的 CI/CD 工具。

要在 Windows 上安装，请参阅在 Windows 上安装 AWS Tools for PowerShell 指南。

要在 Linux 或 Mac 上安装，请参阅在 Linux 或 macOS 上安装 AWS Tools for PowerShell 指南。

可以由 AWS Tools for PowerShell 执行的模块数量以及命令的数量非常多。关于 AWS Lambda，您可以使用这些工具列出、查看、部署、管理和调用函数。

要查看所有可用命令，请运行：

你可以在适用于 AWS Tools for PowerShell Cmdlet 参考中找到所有命令的完整文档，请导航到左栏中的 Lambda 部分。

要列出所有 Lambda 函数，请运行：

要调用 Lambda 函数，请运行：