AWS Lambda 上的 .NET 工作負載

在 Visual Studio 中，轉到「Extension」功能表，然後選取「Manage Extensions」。在右側的搜尋方塊中，鍵入「AWS Toolkit」。在結果窗格中，選取「AWS Toolkit for Visual Studio」擴展程式，然後按一下 Download。按照提示安裝擴展程式，您可能需要重新開機 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 Explorer，它允許您查看和管理許多 AWS 資源，例如 DynamoDB、S3、SNS、SQS 佇列、EC2，當然還有 Lambda 函數。

要開啟 AWS Explorer，請轉到 View 功能表並選取 AWS Explorer。

關於 Lambda 函數，AWS Explorer 允許您：

• 選擇一個區域。
• 查看和管理您的 Lambda 函數。
• 在 AWS 上調用 Lambda 函數，傳遞任何必要的參數，然後查看回應。該工具提供範例輸入，用於類比來自各種其他 AWS 服務的調用。當您組建由其他服務的事件 (例如在 S3 上建立的檔案) 觸發的 Lambda 函數時，這非常有用。
• 偵錯 Lambda 函數的本地執行版本。
• 設定可觸發 Lambda 函數的服務。
• 查看由 Lambda 函數生成的日誌。
  

要從該工具包中調用 Lambda 函數，請開啟 AWS Explorer，展開 Lambda 部分，在要執行的 Lambda 函數上按一下右鍵，然後選取 View Function。

在此處，您可以從下拉清單中選擇一個範例請求。 這些範例允許您類比來自其他 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，請開啟「File」功能表，然後按一下「Settings」和「Plugins」。搜尋 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 函數，請執行：