從 AWS Toolkit for JetBrains 同步 AWS SAM 應用程式 - AWS Toolkit for JetBrains
先決條件 入門 「同步化無伺服器應用程式」對話方塊

從 AWS Toolkit for JetBrains 同步 AWS SAM 應用程式

AWS Serverless Application Model (AWS SAM) sam sync 是一個 AWS SAM CLI 命令部署程序，可自動識別對無伺服器應用程式所做的變更，然後選擇建置這些變更並部署到 AWS 雲端 的最佳方式。如果您只在不變更基礎架構的情況下變更應用程式的程式碼，AWS SAM Sync 會更新您的應用程式，而不會重新部署 AWS CloudFormation 堆疊。

如需 sam sync 和 AWS SAM CLI 的詳細資訊，請參閱《AWS Serverless Application Model 使用者指南》中的 AWS SAM CLI 命令列參考。

下列各節說明如何開始使用 AWS SAM Sync。

先決條件

必須符合下列先決條件才能使用 AWS SAM Sync：

  • 有一個運作中的 AWS SAM 應用程式。如需建立 AWS SAM 應用程式的詳細資訊，請參閱本使用指南中的使用 AWS SAM 主題。

  • 您必須安裝 AWS SAM CLI 的 1.78.0 或更新版本。如需安裝 AWS SAM CLI 的詳細資訊，請參閱《AWS Serverless Application Model 使用者指南》中的安裝 AWS SAM CLI。

  • 應用程式是在開發環境中執行。

注意

若要同步和部署的無伺服器應用程式包含具有任何非預設屬性的 AWS Lambda 函數，部署之前必須在與 AWS Lambda 函數相關聯的 AWS SAM 範本檔中設定選用屬性。

若要進一步了解 AWS Lambda 屬性，請參閱 GitHub 上《AWS Serverless Application Model 使用者指南》中的 AWS::Serverless::Function 一節。

入門

若要開始使用 AWS SAM Sync，請完成下列程序。

注意

確定您的 AWS 區域設定為與您的無伺服器應用程式相關聯的位置。

若要進一步了解如何從 AWS Toolkit for JetBrains 變更 AWS 區域，請參閱本使用指南中的在 AWS 區域之間切換主題。

  1. 在專案工具視窗中，從您的無伺服器應用程式專案開啟 template.yaml 檔案的內容選單 (按右鍵)。

  2. 在 template.yaml 內容選單中，選擇同步無伺服器應用程式 (之前稱為部署)，開啟確認開發堆疊對話方塊。

  3. 確認您正使用開發堆疊開啟同步無伺服器應用程式對話方塊。

    「確認開發堆疊」對話方塊

  4. 完成同步無伺服器應用程式對話方塊中的步驟，然後選擇同步即可開始 AWS SAM Sync 處理程序。若要進一步了解同步無伺服器應用程式對話方塊，請參閱下文的「 「同步化無伺服器應用程式」對話方塊 」一節。

  5. 在同步程序期間，AWS Toolkit for JetBrains 執行視窗會更新部署狀態。

  6. 成功同步後，AWS CloudFormation 堆疊名稱會新增到 AWS Explorer 中。

    如果同步失敗，可在 JetBrains 執行視窗或 AWS CloudFormation 事件日誌中查看疑難排解詳細資訊。若要進一步了解如何檢視 AWS CloudFormation 事件日誌，請參閱本使用指南中的檢視堆疊的事件日誌主題。

「同步化無伺服器應用程式」對話方塊

「同步化無伺服器應用程式」對話方塊可協助您執行 AWS SAM 同步程序。以下各節提供不同對話方塊元件的描述和詳細資料。

建立堆疊或更新堆疊

必要：若要建立新的部署堆疊，請在提供的欄位中輸入名稱，以建立並設定無伺服器應用程式部署的 AWS CloudFormation 堆疊。

或者，若要部署到現有 AWS CloudFormation 堆疊，請從與 AWS 帳戶相關聯的自動填入堆疊清單中選擇堆疊名稱。

範本參數

選用：填入從您的專案 template.yaml 檔案偵測到的參數清單。若要指定參數值，請在值欄中提供的文字欄位中輸入新的參數值。

S3 儲存貯體

必要：若要選擇現有的 Amazon Simple Storage Service (Amazon S3) 儲存貯體來儲存 AWS CloudFormation 範本，請從清單中選取。

若要建立和使用新的 Amazon S3 儲存貯體來儲存，請選擇建立並按照提示進行操作。

ECR 儲存庫

必要，只有在使用 Image 套件類型時才可會顯示：選擇現有 Amazon Elastic Container Registry (Amazon ECR) 儲存庫 URI，以部署無伺服器應用程式。

如需 AWS Lambda 套件類型的詳細資訊，請參閱《AWS Lambda 開發人員指南》中的 Lambda 部署套件。

CloudFormation 功能

必要：選擇 AWS CloudFormation 允許在建立堆疊時使用的功能。

Tags (標籤)

選用：在提供的文字欄位中輸入您偏好的標籤以標記參數。

在容器內建置函數

選用，對 Docker 為必要：若選取此選項，系統會在部署之前於本機 Docker 容器內建置無伺服器應用程式功能。當函數依賴包含原生編譯相依性或程式的套件時，此選項相當實用。

如需詳細資訊，請參閱《AWS Serverless Application Model 開發人員指南》中的建置應用程式主題。