亚马逊 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. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 选择您的项目。

1. 在导航窗格中，选择 **CI/CD**，然后选择**工作流**。

1. 选择工作流的名称。您可以按定义工作流的源存储库或分支名称筛选，也可以按工作流名称或状态筛选。

1. 选择**编辑**。

1. 选择**可视化**。

1. 在左上角，选择 **\$1 操作**打开操作目录。

1. 从下拉列表中选择 A **mazon 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://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 选择您的项目。

1. 在导航窗格中，选择 **CI/CD**，然后选择**工作流**。

1. 选择工作流的名称。您可以按定义工作流的源存储库或分支名称筛选，也可以按工作流名称或状态筛选。

1. 选择**编辑**。

1. 选择 **YAML**。

1. 在左上角，选择 **\$1 操作**打开操作目录。

1. 从下拉列表中选择 A **mazon 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](deploy-action-ecs.md) 中的说明操作，将**部署到 Amazon ECS** 操作添加到工作流中。添加部署操作时，请执行以下操作：

1. 在部署操作的**输入**选项卡中，在**构件 – 可选**中，选择由渲染操作生成的构件。它包含更新后的任务定义文件。

   有关构件的更多信息，请参阅[在操作之间共享构件和文件](workflows-working-artifacts.md)。

1. 在部署操作的 “**配置**” 选项卡的 “**任务定义**” 字段中，指定以下操作变量：`${action-name.task-definition}`其中*action-name*是渲染操作的名称，例如`RenderTaskDef`。渲染操作将此变量设置为任务定义文件的新名称。

   有关变量的更多信息，请参阅[在工作流中使用变量](workflows-working-with-variables.md)。

   有关如何配置部署操作的更多信息，请参阅前面的[示例工作流](render-ecs-action-example-workflow.md)。