Amazon CodeCatalyst 不再向新客戶開放。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[如何從 CodeCatalyst 遷移](migration.md)。

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

# 新增「轉譯 Amazon ECS 任務定義」動作
<a name="render-ecs-action-add"></a>

 使用下列指示，將**轉譯 Amazon ECS 任務定義**動作新增至您的工作流程。

**先決條件**  
開始之前，請確定您有一個工作流程，其中包含可動態產生 Docker 映像的建置動作。如需詳細資訊，請參閱上述[範例工作流程](render-ecs-action-example-workflow.md)。

------
#### [ Visual ]

**使用視覺化編輯器新增「轉譯 Amazon ECS 任務定義」動作**

1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。

1. 選擇您的專案。

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

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

1. 選擇**編輯**。

1. 選擇**視覺化**。

1. 在左上角，選擇 **\$1 動作**以開啟動作目錄。

1. 從下拉式清單中，選擇 **Amazon CodeCatalyst**。

1. 搜尋**轉譯 Amazon ECS 任務定義**動作，並執行下列其中一項操作：
   + 選擇加號 (**\$1**) 將動作新增至工作流程圖表，並開啟其組態窗格。

     或
   + 選擇**轉譯 Amazon ECS 任務定義**。動作詳細資訊對話方塊隨即出現。在此對話方塊中：
     + （選用） 選擇**檢視來源**[以檢視動作的原始程式碼](workflows-view-source.md#workflows-view-source.title)。
     + 選擇**新增至工作流程**，將動作新增至工作流程圖表，然後開啟其組態窗格。

1. 在**輸入**和**組態**索引標籤中，根據您的需求完成欄位。如需每個欄位的說明，請參閱 [「轉譯 Amazon ECS 任務定義」動作 YAML](render-ecs-action-ref.md)。此參考提供在 YAML 和視覺化編輯器中顯示的每個欄位 （和對應的 YAML 屬性值） 的詳細資訊。

1. （選用） 選擇**驗證**以在遞交之前驗證工作流程的 YAML 程式碼。

1. 選擇**遞交**，輸入遞交訊息，然後再次選擇**遞交**。

------
#### [ YAML ]

**使用 YAML 編輯器新增「轉譯 Amazon ECS 任務定義」動作**

1. 開啟 CodeCatalyst 主控台，網址為 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 選擇您的專案。

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

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

1. 選擇**編輯**。

1. 選擇 **YAML**。

1. 在左上角，選擇 **\$1 動作**以開啟動作目錄。

1. 從下拉式清單中，選擇 **Amazon CodeCatalyst**。

1. 搜尋**轉譯 Amazon ECS 任務定義**動作，並執行下列其中一項操作：
   + 選擇加號 (**\$1**) 將動作新增至工作流程圖表，並開啟其組態窗格。

     或
   + 選擇**轉譯 Amazon ECS 任務定義**。動作詳細資訊對話方塊隨即出現。在此對話方塊中：
     + （選用） 選擇**檢視來源**[以檢視動作的原始程式碼](workflows-view-source.md#workflows-view-source.title)。
     + 選擇**新增至工作流程**，將動作新增至工作流程圖表，然後開啟其組態窗格。

1. 根據您的需求修改 YAML 程式碼中的屬性。中提供了每個可用屬性的說明[「轉譯 Amazon ECS 任務定義」動作 YAML](render-ecs-action-ref.md)。

1. （選用） 選擇**驗證**以在遞交之前驗證工作流程的 YAML 程式碼。

1. 選擇**遞交**，輸入遞交訊息，然後再次選擇**遞交**。

------

**後續步驟**

新增轉譯動作之後，請依照 中的指示，將**部署至 Amazon ECS** 動作新增至您的工作流程[使用工作流程部署至 Amazon ECS](deploy-action-ecs.md)。在新增部署動作時，請執行下列動作：

1. 在部署動作的**輸入**索引標籤中，在**成品 - 選用**中，選取轉譯動作產生的成品。它包含更新的任務定義檔案。

   如需成品的詳細資訊，請參閱 [在動作之間共用成品和檔案](workflows-working-artifacts.md)。

1. 在部署動作的**組態**索引標籤中，在**任務定義**欄位中指定下列動作變數：`${action-name.task-definition}`其中 *action-name* 是轉譯動作的名稱，例如 `RenderTaskDef`。轉譯動作會將此變數設定為任務定義檔案的新名稱。

   如需變數的詳細資訊，請參閱 [在工作流程中使用變數](workflows-working-with-variables.md)。

   如需如何設定部署動作的詳細資訊，請參閱上述[工作流程範例](render-ecs-action-example-workflow.md)。