使用 VS 程式碼在本機開發 Lambda 函數 - AWS Lambda

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

使用 VS 程式碼在本機開發 Lambda 函數

您可以將 Lambda 函數從 Lambda 主控台移至 Visual Studio Code,該程式碼提供完整的開發環境,並可讓您使用 AWS SAM 和 等其他本機開發選項 AWS CDK。

本機開發的主要優點

雖然 Lambda 主控台提供快速的函數編輯和測試方法,但本機開發提供更進階的功能:

  • 進階 IDE 功能:偵錯、程式碼完成和重構工具

  • 離線開發:在雲端部署之前在本機工作和測試變更

  • 基礎設施即程式碼整合:與 AWS SAM AWS CDK和 Infrastructure Composer 無縫使用

  • 相依性管理:完全控制函數相依性

先決條件

在 VS Code 中於本機開發 Lambda 函數之前,您必須具有:

注意

如果您已在本機設定 AWS 帳戶和設定檔,請確定 AdministratorAccess 受管政策已新增至您設定的 AWS 設定檔。

身分驗證與存取控制

若要在本機開發 Lambda 函數,您需要 AWS 登入資料來代表您安全地存取和管理 AWS 資源,就像在雲端一樣。 AWS Toolkit for VS Code 支援下列身分驗證方法:

AWS Toolkit for VS Code 支援下列身分驗證方法:

  • IAM 使用者長期憑證

  • 擔任角色的臨時登入資料

  • 聯合身分

  • AWS 帳戶根使用者登入資料 (不建議)

本節會引導您使用 IAM 使用者長期登入資料來取得和設定這些登入資料。

取得 IAM 登入資料

如果您已有具有存取金鑰的 IAM 使用者,請準備好存取金鑰 ID 和私密存取金鑰以供下一節使用。如果您沒有這些金鑰,請依照下列步驟建立它們:

注意

您必須一起使用存取金鑰 ID 和私密存取金鑰來驗證您的請求。

若要建立 IAM 使用者和存取金鑰:

  1. 在 https://https://console.aws.amazon.com/iam/ 開啟 IAM 主控台

  2. 在導覽窗格中,選擇使用者

  3. 選擇 Create user (建立使用者)。

  4. 針對使用者名稱,輸入名稱,然後選擇下一步

  5. 設定許可下,選擇直接連接政策

  6. 選取 AdministratorAccess,然後選擇下一步

  7. 選擇 Create user (建立使用者)。

  8. 在成功橫幅中,選擇檢視使用者

  9. 選擇 Create access key (建立新的存取金鑰)

  10. 針對使用案例,選取本機程式碼

  11. 選取確認核取方塊,然後選擇下一步

  12. (選用) 輸入描述標籤值。

  13. 選擇 Create access key (建立新的存取金鑰)

  14. 立即複製您的存取金鑰和私密存取金鑰。離開此頁面後,您將無法再次存取私密存取金鑰。

重要

切勿共用您的私密金鑰或將其遞交至來源控制。安全地存放這些金鑰,並在不再需要時將其刪除。

使用 AWS Toolkit 設定 AWS 登入資料

下表摘要說明您將在下列程序中完成的登入資料設定程序。

要做什麼 為什麼?
開啟登入面板 開始驗證
使用命令調色盤,搜尋 AWS 新增連線 存取登入 UI
選擇 IAM 登入資料 使用您的存取金鑰進行程式設計存取
輸入設定檔名稱、存取金鑰、私密金鑰 提供 連線的登入資料
請參閱 AWS Explorer 更新 確認您已連線

完成向 AWS 您的帳戶進行身分驗證的步驟:

  1. 在 VS 程式碼中開啟登入面板:

    1. 若要開始身分驗證程序,請選取左側導覽窗格中的 AWS 圖示,或開啟命令面板 (Mac 上的 Cmd+Shift+P 或 Windows/Linux 上的 Ctrl+Shift+P),然後搜尋並選取AWS 新增連線

  2. 在登入面板中,選擇 IAM 登入資料,然後選取繼續

    注意

    若要繼續,您需要允許 VS 程式碼的 IDE AWS 延伸存取您的資料。

  3. 輸入您的設定檔名稱、存取金鑰 ID 和私密存取金鑰,然後選取繼續

  4. 檢查您 AWS 服務和資源的 VS Code 中的 AWS Explorer 來驗證連線。

如需使用長期憑證設定身分驗證的資訊,請參閱使用長期憑證來驗證 AWS SDKs和工具

如需有關設定身分驗證的資訊,請參閱 AWS Toolkit for Visual Studio Code 《 使用者指南》中的 AWS IAM 登入資料。

從主控台移至本機開發

注意

如果您在 主控台中進行了變更,請確保您沒有任何未部署的變更,然後再轉換為本機開發。

若要將 Lambda 函數從 Lambda 主控台移至 VS 程式碼,請完成下列步驟:

  1. 開啟 Lambda 主控台

  2. 選擇 函數的名稱。

  3. 選取程式碼來源索引標籤。

  4. 選擇在 Visual Studio 程式碼中開啟

    注意

    Open in Visual Studio Code 按鈕僅適用於 AWS Toolkit 3.69.0 版及更新版本。如果您已安裝舊版的 AWS Toolkit,您可能會在 VS 程式碼中看到Cannot open the handler訊息。若要解決此問題,請將您的 AWS Toolkit 更新至最新版本。

  5. 出現提示時,允許您的瀏覽器開啟 VS 程式碼。

當您在 VS 程式碼中開啟函數時,Lambda 會在專為快速測試和部署而設計的暫時位置,使用函數程式碼建立本機專案。這包括函數程式碼、相依性,以及可用於本機開發的基本專案結構。

如需在 VS 程式碼 AWS 中使用 的詳細資訊,請參閱 AWS Toolkit for Visual Studio Code 使用者指南

在本機使用 函數

在 VS Code 中開啟函數後,請依照下列步驟存取和管理函數:

  1. 選取側邊欄中的 AWS 圖示以開啟 AWS Explorer:

    AWS VS 程式碼邊欄中的工具組圖示
  2. 在 AWS Explorer 中,選取具有 Lambda 函數的區域:

    AWS 檔案總管顯示區域選擇
  3. 在您選取的區域下,展開 Lambda 區段以檢視和管理函數:

    具有用於部署、調用等動作圖示的 Lambda 函數

在 VS Code 中開啟函數後,您可以:

  • 使用完整語言支援和程式碼完成來編輯函數程式碼。

  • 使用 AWS Toolkit 在本機測試您的函數。

  • 使用中斷點和變數檢查對函數進行偵錯。

  • AWS 使用雲端圖示將更新的函數部署回 。

  • 安裝和管理 函數的相依性。

如需詳細資訊,請參閱 AWS Toolkit for Visual Studio Code 《 使用者指南》中的使用 AWS Lambda 函數

將您的函數轉換為 AWS SAM 範本並使用 IaC 工具

在 VS 程式碼中,您可以選擇 Lambda 函數旁的轉換為 AWS SAM 應用程式圖示,將 Lambda 函數轉換為 AWS SAM 範本。系統會提示您選取 AWS SAM 專案位置。選取後,您的 Lambda 函數將轉換為儲存在新 AWS SAM 專案中的template.yaml檔案。

將函數轉換為 AWS SAM 範本後,您可以:

  • 控制基礎設施的版本控制

  • 自動化部署

  • 遠端偵錯函數

  • 將其他 AWS 資源新增至您的應用程式

  • 在整個開發生命週期中維持一致的環境

  • 使用 Infrastructure Composer 以視覺化方式編輯您的 AWS SAM 範本

如需使用 IaC 工具的詳細資訊,請參閱下列指南:

這些工具提供定義、測試和部署無伺服器應用程式的其他功能。

後續步驟

若要進一步了解如何在 VS Code 中使用 Lambda 函數,請參閱下列資源: