將環境與動作建立關聯

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

使用以下指示，將環境與動作建立關聯。

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

使用下列程序將環境與工作流程動作建立關聯。

Visual

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

在 https：//https://codecatalyst.aws/ 開啟 CodeCatalyst 主控台。
選擇您的專案。
在導覽窗格中，選擇 CI/CD，然後選擇工作流程。
選擇工作流程的名稱。您可以依定義工作流程的來源儲存庫或分支名稱進行篩選，或依工作流程名稱或狀態進行篩選。
選擇編輯。
選擇視覺化。
在工作流程圖表中，選擇環境支援的動作。如需詳細資訊，請參閱哪些動作支援在 CodeCatalyst 中顯示其部署資訊？。
選擇組態索引標籤，並在環境欄位中指定資訊，如下所示。

Environment (環境)

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

注意
如果預設 IAM 角色沒有動作所需的許可，您可以將動作設定為使用不同的角色。如需詳細資訊，請參閱變更動作的 IAM 角色。

如需環境的詳細資訊，請參閱部署至 AWS 帳戶和 VPCs和建立環境。
（選用）變更與動作相關聯的 IAM 角色。如果角色包含動作的錯誤許可集，您可能想要變更角色。

若要變更角色：
1. 在我的環境 ？ 方塊中，選擇垂直省略號圖示 ( )。
2. 選擇下列其中一項：
  - 切換角色。選擇此選項可變更此動作所使用的 IAM 角色，且僅變更此動作。其他動作會繼續使用其相關聯環境中指定的預設 IAM 角色。如需詳細資訊，請參閱變更動作的 IAM 角色。
  - 編輯環境。選擇此選項可變更您環境中列出的預設 IAM 角色。當您選擇此選項時，您的動作以及與相同環境相關聯的任何其他動作都會開始使用新的預設 IAM 角色。
    
    重要
    更新預設 IAM 角色時請小心。如果角色中的許可不足以用於共用環境的所有動作，變更角色可能會導致動作失敗。
（選用）選擇驗證以在遞交之前驗證工作流程的 YAML 程式碼。
選擇遞交，輸入遞交訊息，然後再次選擇遞交。

YAML

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

在 https：//https://codecatalyst.aws/ 開啟 CodeCatalyst 主控台。
選擇您的專案。
在導覽窗格中，選擇 CI/CD，然後選擇工作流程。
選擇工作流程的名稱。您可以依定義工作流程的來源儲存庫或分支名稱進行篩選，或依工作流程名稱或狀態進行篩選。
選擇編輯。
選擇 YAML。
在您想要與環境建立關聯的工作流程動作中，新增類似以下的程式碼：
```
action-name:
  Environment:
    Name: environment-name
```
如需詳細資訊，請參閱動作類型主題。本主題包含每個動作的文件連結，包括其 YAML 參考。
（選用）如果您想要動作使用與環境中列出的預設 IAM 角色不同的角色，請新增包含您要使用之角色的Connections:區段。如需詳細資訊，請參閱變更動作的 IAM 角色。
（選用）選擇驗證以在遞交之前驗證工作流程的 YAML 程式碼。
選擇遞交，輸入遞交訊息，然後再次選擇遞交。

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

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

注意

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

將部署資訊新增至 CodeCatalyst

如果您在中遞交變更時，工作流程執行未自動啟動步驟 1：將環境與工作流程動作建立關聯，請手動啟動執行，如下所示：
1. 在導覽窗格中，選擇 CI/CD，然後選擇工作流程。
2. 選擇工作流程的名稱。您可以依定義工作流程的來源儲存庫或分支名稱進行篩選，或依工作流程名稱或狀態進行篩選。
3. 選擇執行。
工作流程執行會啟動新的部署，這會導致 CodeCatalyst 將部署資訊新增至 CodeCatalyst。
確認部署活動已新增至 CodeCatalyst 主控台：
1. 在導覽窗格中，選擇 CI/CD，然後選擇環境。
2. 選擇您的環境（例如 Production)。
3. 選擇部署活動索引標籤，並確認部署的狀態為 SUCCEEDED。這表示工作流程執行成功部署您的應用程式資源。
4. 選擇部署目標索引標籤，並確認您的應用程式資源是否出現。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

建立環境

將 VPC 與環境建立關聯

將環境與 動作建立關聯