

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

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

# 在第三方存储库事件发生后自动启动工作流运行
<a name="extensions-workflow-repositories"></a>

您可以使用链接 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库作为工作流程的来源，其中对链接存储库、Bitbucket GitHub 存储库或 GitLab 项目存储库中指定分支的更改会自动启动工作流程运行。

*工作流*是一个自动化过程，它描述了如何在持续集成和持续交付（CI/CD）系统中构建、测试和部署代码。工作流定义了在工作流运行期间要执行的一系列步骤，也称为*操作*。工作流还定义了促使工作流启动的事件或*触发器*。要设置工作流程，您可以使用 CodeCatalyst 控制台[的可视化或 YAML 编辑器](https://docs.aws.amazon.com//codecatalyst/latest/userguide/flows.html#workflow.editors)创建*工作流程定义文件*。

**提示**  
要快速了解如何在项目中使用工作流，请[使用蓝图创建项目](https://docs.aws.amazon.com//codecatalyst/latest/userguide/projects-create.html#projects-create-console-template)。每个蓝图都部署了一个可以正常运行的工作流，您可以对工作流进行查看、运行和试验。

将工作流程配置为使用链接 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库时，工作流程配置文件存储在该存储 GitHub 库、Bitbucket 存储库或 GitLab 项目存储库中。工作流配置是一个 YAML 文件，用于定义工作流名称、触发器、资源、构件和操作。有关工作流配置文件的更多信息，请参阅[工作流 YAML 定义](workflow-reference.md)。

工作流程配置文件必须位于 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库的`./codecatalyst/workflows/`目录中。

您可以使用工作流编辑器来创建和配置工作流。有关更多信息，请参阅[入门工作流](workflows-getting-started.md)和[将源存储库连接到工作流](workflows-sources.md)。

## 添加触发器以启动工作流运行
<a name="extensions-workflow-trigger-repositories"></a>

您可以将 CodeCatalyst 工作流程配置为在将代码推送到您 GitHub 或 Bitbucket 存储库的指定分支时自动开始运行。要自动启动工作流运行，请在工作流配置文件的 `Triggers` 部分中添加触发器。

### 示例：一个简单的代码推送触发器
<a name="extensions-workflows-add-trigger-examples-push-simple"></a>

以下示例显示了一个触发器，在代码被推送到源存储库中的任何分支时，该触发器将启动工作流运行。

```
Triggers:
  - Type: PUSH
```

### 示例：一个简单的拉取请求触发器
<a name="extensions-workflows-add-trigger-examples-push-simple"></a>

以下示例显示了一个触发器，在针对源存储库中的任何分支创建拉取请求时，该触发器将启动工作流运行。

```
Triggers:
  - Type: PULLREQUEST
    Events:
      - OPEN
```

有关更多信息，请参阅 [使用触发器自动启动工作流运行](workflows-add-trigger.md)。