本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用 VS 程式碼在本機開發 Lambda 函數
您可以將 Lambda 函數從 Lambda 主控台移至 Visual Studio Code,該程式碼提供完整的開發環境,並可讓您使用 AWS SAM 和 等其他本機開發選項 AWS CDK。
本機開發的主要優點
雖然 Lambda 主控台提供快速的函數編輯和測試方法,但本機開發提供更進階的功能:
-
進階 IDE 功能:偵錯、程式碼完成和重構工具
-
離線開發:在雲端部署之前在本機工作和測試變更
-
基礎設施即程式碼整合:與 AWS SAM AWS CDK和 Infrastructure Composer 無縫使用
-
相依性管理:完全控制函數相依性
先決條件
在 VS Code 中於本機開發 Lambda 函數之前,您必須具有:
-
VS 程式碼:如需安裝說明,請參閱下載 VS 程式碼
。 -
AWS Toolkit for Visual Studio Code:如需安裝說明,請參閱設定 AWS Toolkit for Visual Studio Code。如需概觀,請參閱 AWS Toolkit for Visual Studio Code
。 -
AWS 登入資料:如需設定登入資料的相關資訊,請參閱設定您的 AWS 登入資料。
-
AWS SAMCLI:如需安裝說明,請參閱安裝 AWS SAMCLI。
-
已安裝 Docker (選用,但本機測試需要):如需安裝指示,請參閱取得 Docker
。
注意
如果您已在本機設定 AWS 帳戶和設定檔,請確定 AdministratorAccess 受管政策已新增至您設定的 AWS 設定檔。
身分驗證與存取控制
若要在本機開發 Lambda 函數,您需要 AWS 登入資料來代表您安全地存取和管理 AWS 資源,就像在雲端一樣。 AWS Toolkit for VS Code 支援下列身分驗證方法:
AWS Toolkit for VS Code 支援下列身分驗證方法:
-
IAM 使用者長期憑證
-
擔任角色的臨時登入資料
-
聯合身分
-
AWS 帳戶根使用者登入資料 (不建議)
本節會引導您使用 IAM 使用者長期登入資料來取得和設定這些登入資料。
取得 IAM 登入資料
如果您已有具有存取金鑰的 IAM 使用者,請準備好存取金鑰 ID 和私密存取金鑰以供下一節使用。如果您沒有這些金鑰,請依照下列步驟建立它們:
注意
您必須一起使用存取金鑰 ID 和私密存取金鑰來驗證您的請求。
若要建立 IAM 使用者和存取金鑰:
-
在 https://https://console.aws.amazon.com/iam/
開啟 IAM 主控台 -
在導覽窗格中,選擇使用者 。
-
選擇 Create user (建立使用者)。
-
針對使用者名稱,輸入名稱,然後選擇下一步。
-
在設定許可下,選擇直接連接政策。
-
選取 AdministratorAccess,然後選擇下一步。
-
選擇 Create user (建立使用者)。
-
在成功橫幅中,選擇檢視使用者。
-
選擇 Create access key (建立新的存取金鑰)。
-
針對使用案例,選取本機程式碼。
-
選取確認核取方塊,然後選擇下一步。
-
(選用) 輸入描述標籤值。
-
選擇 Create access key (建立新的存取金鑰)。
-
立即複製您的存取金鑰和私密存取金鑰。離開此頁面後,您將無法再次存取私密存取金鑰。
重要
切勿共用您的私密金鑰或將其遞交至來源控制。安全地存放這些金鑰,並在不再需要時將其刪除。
注意
如需詳細資訊,請參閱《IAM 使用者指南》中的在 AWS 帳戶中建立 IAM 使用者和管理 IAM 使用者的存取金鑰。
使用 AWS Toolkit 設定 AWS 登入資料
下表摘要說明您將在下列程序中完成的登入資料設定程序。
要做什麼 | 為什麼? |
---|---|
開啟登入面板 | 開始驗證 |
使用命令調色盤,搜尋 AWS 新增連線 | 存取登入 UI |
選擇 IAM 登入資料 | 使用您的存取金鑰進行程式設計存取 |
輸入設定檔名稱、存取金鑰、私密金鑰 | 提供 連線的登入資料 |
請參閱 AWS Explorer 更新 | 確認您已連線 |
完成向 AWS 您的帳戶進行身分驗證的步驟:
-
在 VS 程式碼中開啟登入面板:
-
若要開始身分驗證程序,請選取左側導覽窗格中的 AWS 圖示,或開啟命令面板 (Mac 上的 Cmd+Shift+P 或 Windows/Linux 上的 Ctrl+Shift+P),然後搜尋並選取AWS 新增連線。
-
-
在登入面板中,選擇 IAM 登入資料,然後選取繼續。
注意
若要繼續,您需要允許 VS 程式碼的 IDE AWS 延伸存取您的資料。
-
輸入您的設定檔名稱、存取金鑰 ID 和私密存取金鑰,然後選取繼續。
-
檢查您 AWS 服務和資源的 VS Code 中的 AWS Explorer 來驗證連線。
如需使用長期憑證設定身分驗證的資訊,請參閱使用長期憑證來驗證 AWS SDKs和工具。
如需有關設定身分驗證的資訊,請參閱 AWS Toolkit for Visual Studio Code 《 使用者指南》中的 AWS IAM 登入資料。
從主控台移至本機開發
注意
如果您在 主控台中進行了變更,請確保您沒有任何未部署的變更,然後再轉換為本機開發。
若要將 Lambda 函數從 Lambda 主控台移至 VS 程式碼,請完成下列步驟:
-
開啟 Lambda 主控台
。 -
選擇 函數的名稱。
-
選取程式碼來源索引標籤。
-
選擇在 Visual Studio 程式碼中開啟。
注意
Open in Visual Studio Code 按鈕僅適用於 AWS Toolkit 3.69.0 版及更新版本。如果您已安裝舊版的 AWS Toolkit,您可能會在 VS 程式碼中看到
Cannot open the handler
訊息。若要解決此問題,請將您的 AWS Toolkit 更新至最新版本。 -
出現提示時,允許您的瀏覽器開啟 VS 程式碼。
當您在 VS 程式碼中開啟函數時,Lambda 會在專為快速測試和部署而設計的暫時位置,使用函數程式碼建立本機專案。這包括函數程式碼、相依性,以及可用於本機開發的基本專案結構。
如需在 VS 程式碼 AWS 中使用 的詳細資訊,請參閱 AWS Toolkit for Visual Studio Code 使用者指南。
在本機使用 函數
在 VS Code 中開啟函數後,請依照下列步驟存取和管理函數:
-
選取側邊欄中的 AWS 圖示以開啟 AWS Explorer:
-
在 AWS Explorer 中,選取具有 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 函數,請參閱下列資源:
-
《 AWS Toolkit for VS Code 使用者指南》中的使用 AWS Lambda 函數
-
《 AWS Toolkit for VS 程式碼使用者指南》中的使用無伺服器應用程式
-
Lambda 開發人員指南中的基礎設施即程式碼