建立環境與動作的關聯

當您將環境與支援的工作流程動作相關聯時，該環境 AWS 帳戶、預設IAM角色和選用的 Amazon 都VPC會指派給動作。然後，該動作可以 AWS 帳戶 使用IAM角色連接並部署到，並連接到可選的 Amazon VPC。

使用下列指示將環境與動作相關聯。

步驟 1：將環境與工作流程動作相關聯

使用下列步驟將環境與工作流程動作相關聯。

Visual

使用視覺化編輯器將環境與工作流程動作相關聯

1. 請在以下位置開啟 CodeCatalyst 主控台。 https://codecatalyst.aws/

2. 選擇您的專案。

3. 在瀏覽窗格中，選擇 CI/CD，然後選擇 [工作流程]。

4. 選擇工作流程的名稱。您可以依定義工作流程的來源儲存庫或分支名稱進行篩選，或依工作流程名稱或狀態進行篩選。

5. 選擇編輯。

6. 選擇 [視覺]。

7. 在工作流程圖中，選擇環境支援的動作。如需詳細資訊，請參閱 哪些動作支援在其部署資訊中顯示 CodeCatalyst？。

8. 選擇「組態」頁籤，然後在「環境」欄位中指定資訊，如下所示。

   Environment (環境)

   指定要與動作搭配使用的 CodeCatalyst 環境。該動作連接到所選環境中VPC指定的 AWS 帳戶 和可選的 Amazon。該動作使用環境中指定的預設IAM角色連接到 AWS 帳戶，並使用 Amazon VPC 連接中指定的IAM角色連接到 Amazon VPC。

   注意

   如果預設IAM角色沒有動作所需的權限，您可以將動作配置為使用其他角色。如需詳細資訊，請參閱 變更動IAM作的角色。

   若要取得有關環境的更多資訊，請參閱部署到 AWS 帳戶 和 VPCs和建立環境。

9. (選擇性) 變更與動IAM作相關聯的角色。如果角色包含動作的權限組錯誤，您可能會想要變更角色。

   若要變更角色：

   1. 在什麼 my-environment ? 」方塊中，然後選擇垂直省略符號圖示 ( )。

   2. 選擇下列其中一項：

      • 切換角色。選擇此選項可變更此動作所使用的IAM角色，並僅變更此動作。其他動作會繼續使用在其關聯環境中指定的預設IAM角色。如需詳細資訊，請參閱 變更動IAM作的角色。

      • 編輯環境。選擇此選項可變更環境中列出的預設IAM角色。當您選擇此選項時，您的動作以及與相同環境相關聯的任何其他動作都會開始使用新的預設角色。IAM

        重要

        更新預設IAM角色時請小心。如果角色中的權限不足以執行共用環境的所有動作，變更角色可能會導致動作失敗。

10. (選擇性) 選擇「驗證」，在確認之前驗證工作流程的程YAML式碼。

11. 選擇「確認」，輸入確認訊息，然後再次選擇「確認」。

YAML

使用YAML編輯器將環境與工作流程動作相關聯

1. 請在以下位置開啟 CodeCatalyst 主控台。 https://codecatalyst.aws/

2. 選擇您的專案。

3. 在瀏覽窗格中，選擇 CI/CD，然後選擇 [工作流程]。

4. 選擇工作流程的名稱。您可以依定義工作流程的來源儲存庫或分支名稱進行篩選，或依工作流程名稱或狀態進行篩選。

5. 選擇編輯。

6. 選擇YAML。

7. 在您要與環境產生關聯的工作流程動作中，新增類似下列內容的程式碼：

   action-name:
     Environment:
       Name: environment-name

   如需詳細資訊，請參閱動作類型主題。本主題包含每個動作的文件連結，包括其YAML參考資料。

8. (選擇性) 如果您希望動作使用與環境中列出的預設IAM角色不同的角色，請新增包含您要使用之角色的Connections:區段。如需詳細資訊，請參閱 變更動IAM作的角色。

9. (選擇性) 選擇「驗證」，在確認之前驗證工作流程的程YAML式碼。

10. 選擇「確認」，輸入確認訊息，然後再次選擇「確認」。

步驟 2：填入部署活動頁面

將環境與工作流程動作產生關聯後，您可以將部署資訊填入 CodeCatalyst 主控台「環境」區段中的「部署」活動和「部署」目標頁面。請使用下列指示來填入這些頁面。

注意

只有少數動作支援在 CodeCatalyst主控台中顯示其部署資訊。如需詳細資訊，請參閱 哪些動作支援在其部署資訊中顯示 CodeCatalyst？。

若要將部署資訊加入至 CodeCatalyst

1. 如果在中提交變更時，工作流程執行未自動啟動步驟 1：將環境與工作流程動作相關聯，請依照下列步驟手動啟動執行：

   1. 在瀏覽窗格中，選擇 CI/CD，然後選擇 [工作流程]。

   2. 選擇工作流程的名稱。您可以依定義工作流程的來源儲存庫或分支名稱進行篩選，或依工作流程名稱或狀態進行篩選。

   3. 選擇執行。

   工作流程執行會啟動新部署，導 CodeCatalyst 致將部署資訊加入至 CodeCatalyst。

2. 確認已將部署活動新增至主 CodeCatalyst 控台：

   1. 在瀏覽窗格中，選擇 CI/CD，然後選擇 [環境]。

   2. 選擇您的環境 (例如，Production)。

   3. 選擇「部署活動」索引標籤，並確認部署顯示的狀態為SUCCEEDED。這表示工作流程執行已成功部署您的應用程式資源。

   4. 選擇 [部署目標] 索引標籤，並確認應用程式資源是否顯示。