亚马逊 CodeCatalyst 不再向新买家开放。现有客户可以继续正常使用该服务。有关更多信息，请参阅 [如何从中迁移 CodeCatalyst](migration.md)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 引用预定义变量
<a name="workflows-working-with-variables-reference-output-vars"></a>

您可以在 Amazon CodeCatalyst 工作流程中的任何操作中引用预定义变量。

按照以下说明在工作流中引用预定义变量。

有关预定义变量的更多信息，请参阅[使用预定义变量](workflows-using-predefined-variables.md)。

**先决条件**  
确定要引用的预定义变量的名称，例如 `CommitId`。有关更多信息，请参阅[确定您的工作流会发出哪些预定义变量](workflows-working-with-variables-determine-output-vars.md)。

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

*不可用。选择 YAML 以查看 YAML 说明。*

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

**引用预定义变量（YAML 编辑器）**

1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 选择您的项目。

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

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

1. 选择**编辑**。

1. 选择 **YAML**。

1. 在 CodeCatalyst 操作中，使用以下语法添加预定义的变量引用：

   ```
   ${{{action-group-name}}.{{action-name-or-WorkflowSource}}.{{variable-name}}}
   ```

   进行如下替换：
   + {{action-group-name}}用行动组的名字。
**注意**  
{{action-group-name}}如果没有操作组，或者变量是由同一操作组中的操作生成的，则可以省略。
   + {{action-name-or-WorkflowSource}}和：

     输出变量的操作的名称。

     或

     `WorkflowSource`，如果变量是 `BranchName` 或 `CommitId` 变量。
   + {{variable-name}}用变量的名字。

   例如：

   ```
   MySecondAction:
       Configuration:
         Steps:
           - Run: echo ${MyFirstECSAction.cluster}
   ```

   另一个示例是：

   ```
   MySecondAction:
       Configuration:
         Steps:
           - Run: echo ${WorkflowSource.CommitId}
   ```

   有关更多示例，请参阅[引用预定义变量的示例](workflows-predefined-examples.md)。有关更多信息，请参阅相应操作的[工作流 YAML 定义](workflow-reference.md)。

1. （可选）选择**验证**，在提交之前验证工作流的 YAML 代码。

1. 选择**提交**，输入提交消息，然后再次选择**提交**。

------