基本 AWS Lambda 項目 - AWS Amazon Q 的工具包

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

基本 AWS Lambda 項目

您可以使 Lambda Microsoft 核心專案範本,在 AWS Toolkit for Visual Studio.

建立視覺工作室 .NET 核心 Lambda 專案

您可以使用 Lambda 視覺工作室範本和藍圖來協助加速專案初始化。Lambda 藍圖包含預先撰寫的函數,可簡化彈性專案基礎的建立作業。

注意

Lambda 服務對不同的封裝類型有資料限制。如需有關資料限制的詳細資訊,請參閱 Lambda 使用者指南中的 AWS Lambda 配額主題。

若要在視覺工作室中建立 Lambda 專案
  1. 從 Visual Studio 展開 [檔案] 功能表,展開 [新增],然後選擇 [案]。

  2. 在「新增專案」對話方塊中,將「語言」、「平台」和「專案類型」下拉式方塊設定為「全部」,然後aws lambda在「搜尋」欄位中輸入。選擇 L AWS ambda 專案 (.NET 核心-C#) 範本。

  3. 在「名稱」欄位中,輸入AWSLambdaSample,指定您想要的檔案「位置」,然後選擇「建立」以繼續。

  4. 從 [選取藍圖] 頁面中,選取空白函式藍圖,然後選擇 [完成] 以建立 Visual Studio 專案。

檢閱專案檔

有兩個專案檔案可供檢閱:aws-lambda-tools-defaults.jsonFunction.cs

下列範例顯示aws-lambda-tools-defaults.json檔案,該檔案會自動建立為專案的一部分。您可以使用此檔案中的欄位來設定建置選項。

注意

Visual Studio 中的專案範本包含許多不同的欄位,請注意下列事項:

  • 函數處理程序:指定 Lambda 函數運行時運行的方法

  • 函數處理常式欄位中指定值,會在「發佈」精靈中預先填入該值。

  • 如果重命名函數,類或程序集,那麼您還需要更新aws-lambda-tools-defaults.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": "us-west-2", "configuration": "Release", "function-architecture": "x86_64", "function-runtime": "dotnet8", "function-memory-size": 512, "function-timeout": 30, "function-handler": "AWSLambdaSample::AWSLambdaSample.Function::FunctionHandler" }

檢查Function.cs檔案。 Function.cs定義 c# 函數以公開為 Lambda 函數。這FunctionHandler是 Lambda 函數執行時執行的 Lambda 功能。在這個項目中,定義了一個函數:FunctionHandler,它調ToUpper()用輸入文本。

您的專案現在已準備就緒,可以發佈到 Lambda。

發佈至 Lambda

下列程序和影像示範如何使用將函數上傳至 Lambda AWS Toolkit for Visual Studio。

調用測試功能頁
將您的函數發佈至 Lambda
  1. 展開「檢」並選擇「 AWS 檔案總管」,導覽至AWS 檔案總管

  2. 解決方案總管中,開啟 (以滑鼠右鍵按一下) 要發佈之專案的內容功能表,然後選擇「發佈至 AWS Lambda」以開啟「上傳 Lambda 函數」視窗。

  3. 在「上傳 Lambda 函數」視窗中,完成下列欄位:

    1. Package 類型:選擇Zip。建置程序的結果會建立一個 ZIP 檔案,並將上傳至 Lambda。或者,您也可以選擇「P ackage 類型Image教學課程:基本 Lambda 專案建立 Docker 映像檔說明如何使用 P ackage 類型Image發佈。

    2. Lambda 執行階段:從下拉式功能表中選擇 Lambda 執行階段

    3. 架構:為您偏好的架構選擇徑向。

    4. 函數名稱:為建立新函數選取徑向,然後輸入 Lambda 執行個體的顯示名稱。 AWS 檔案總管和 AWS Management Console 顯示器都會參考此名稱。

    5. 處理程式:使用此欄位可指定函數處理常式。例如:AWSLambdaSample::AWSLambdaSample.Function::FunctionHandler

    6. (選擇性) 說明:從中輸入要與執行環境一起顯示的描述性文字 AWS Management Console。

    7. 組態:從下拉式功能表中選擇您偏好的組態。

    8. 架構:從下拉式選單中選擇您偏好的架構。

    9. 儲存設定:選取此方塊可將目前的設定儲存aws-lambda-tools-defaults.json為 future 部署的預設值。

    10. 選擇下一步,繼續進行「進階功能詳細資訊」視窗。

  4. 在「進階功能詳細資訊」視窗中,完成下列欄位:

    1. 角色名稱:選擇與您帳戶相關聯的角色。此角色會為函式中的程式碼所發出的任何 AWS 服務呼叫提供暫時認證。如果您沒有角色,請捲動以在下拉式選取器中尋找根據 AWS 受管理策略的新角色,然後選擇AWSLambdaBasicExecutionRole。此角色具有最小的存取權限。

      注意

      您的帳戶必須具有執行 IAM ListPolicies 動作的權限,否則「角色名稱」清單將為空,您將無法繼續。

    2. (選用) 如果您的 Lambda 函數存取 Amazon VPC 上的資源,請選取子網路和安全群組。

    3. (選擇性) 設定 Lambda 函數需要的任何環境變數。這些密鑰由默認服務密鑰自動加密,該密鑰是免費的。或者,您可以指定一個 AWS KMS 鍵,其中有一個收費。KMS 是一項受管服務,可用來建立和控制用於加密資料的加密金鑰。如果您有 AWS KMS 金鑰,您可以從清單中選取金鑰。

  5. 選擇「上傳」以開啟「上傳功能」視窗並開始上傳處理。

    注意

    傳函數時,會顯示 [上載功能] 頁面 AWS。若要在上傳之後保持精靈開啟,以便您可以檢視報表,請在上傳完成前清除表單底部表單底部的 [成功完成時自動關閉精靈]

    函數上傳之後,您的 Lambda 函數就會上線。「函數:檢視」頁面隨即開啟,並顯示新的 Lambda 函數組態。

  6. 在「測試函數」標籤hello lambda!中,輸入文字輸入欄位,然後選擇叫用以手動呼叫 Lambda 函數。您的文本顯示在「響應」標簽中,并轉換為大寫字母。

    注意

    您可以隨時重新開啟 F unction: 檢視,方法是在AWS Lambda節點下方的AWS 檔案總管中連按兩下已部署的執行個體。

    調用測試功能頁
  7. (選擇性) 若要確認您已成功發佈 Lambda 函數,請登入, AWS Management Console 然後選擇 Lambda。主控台會顯示所有已發佈的 Lambda 函數,包括您剛建立的函數。

清理

如果您不打算繼續使用此範例進行開發,請刪除您部署的函數,這樣就不會針對帳戶中未使用的資源向您收取費用。

注意

Lambda 會自動為您監控 Lambda 函數,並透過 Amazon 報告指標 CloudWatch。若要監控和疑難排解您的函數,請參閱 AWS Lambda 開發人員指南中的使用 Amazon 疑難排解和監控 AWS Lambda 函數 CloudWatch主題。

若要刪除您的函數
  1. AWS 總管中展開AWS Lambda節點。

  2. 在部署的執行個體上按一下滑鼠右鍵,然選擇