亚马逊 CodeCatalyst 不再向新买家开放。现有客户可以继续正常使用该服务。有关更多信息，请参阅 [如何从中迁移 CodeCatalyst](migration.md)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 为带有扩展程序的项目添加功能 CodeCatalyst
Amazon CodeCatalyst 包含扩展程序，可帮助您添加功能并与之外的产品集成 CodeCatalyst。使用 CodeCatalyst 目录中的扩展，团队可以在中自定义自己的体验 CodeCatalyst。
**Topics**
+ [可用的第三方扩展](#extensions-types)
+ [扩展概念](extensions-concepts.md)
+ [快速入门：安装扩展、连接提供商和链接资源 CodeCatalyst](extensions-quickstart.md)
+ [在空间中安装扩展](install-extension.md)
+ [卸载空间中的扩展](uninstall-extension.md)
+ [关联 GitHub 账户、Bitbucket 工作空间、 GitLab 用户和 Jira 站点 CodeCatalyst](extensions-connect.md)
+ [断开 GitHub 账户、Bitbucket 工作空间、 GitLab 用户和 Jira 网站的连接 CodeCatalyst](extensions-disconnect.md)
+ [在中关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst](extensions-link.md)
+ [取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst](extensions-unlink.md)
+ [在中查看第三方存储库并搜索 Jira 事务 CodeCatalyst](extensions-view-search.md)
+ [在第三方存储库事件发生后自动启动工作流运行](extensions-workflow-repositories.md)
+ [限制第三方存储库提供程序的 IP 访问权限](extensions-restrict-ip-access.md)
+ [在工作流失败时阻止第三方合并](extensions-block-merges.md)
+ [将 Jira 事务与拉 CodeCatalyst 取请求相关联](link-jira-issues-pull-requests.md)
+ [在 Jira 事务中查看 CodeCatalyst 事件](view-codecatalyst-events-jira.md)
## 可用的第三方扩展
您可以根据您选择与之集成资源的扩展程序为 CodeCatalyst 项目添加特定功能。
### 将 GitHub 存储库集成到 CodeCatalyst
GitHub 是一项基于云的服务，可帮助开发人员存储和管理他们的代码。**GitHub 存储库**扩展允许您在 Amazon CodeCatalyst 项目中使用链接 GitHub 存储库。您还可以在创建新 CodeCatalyst 项目时链接 GitHub 存储库。有关更多信息，请参阅 [使用链接的第三方存储库创建项目](projects-create.md#projects-create-3p-repo)。
**注意**
您不能在 CodeCatalyst 项目中使用空仓库或已存档 GitHub 存储库。
**GitHub 存储库**扩展与 GitHub 企业服务器存储库不兼容。
安装和配置**GitHub 存储库**扩展后，您将能够：
+ 在中的源 GitHub 存储库列表中查看您的仓库 CodeCatalyst
+ 在存储库中 GitHub 存储和管理工作流程定义文件
+ 在 CodeCatalyst 开发环境中创建、读取、更新和删除存储在链接 GitHub 存储库中的文件
+ 将链接存储库中的文件 GitHub 存储在中并为其编制索引 CodeCatalyst
+ 使用已关联 GitHub 账户的现有存储库创建 CodeCatalyst 项目
+ 使用蓝图创建项目或添加蓝图时，使用蓝图生成的代码创建 GitHub 存储库
+ 当代码被推送到链接 GitHub 存储库时，或者在链接存储库中创建、修改或关闭拉取请求时，启动 CodeCatalyst 工作流程会自动运行 GitHub
+ 在 CodeCatalyst 工作流程中使用链接 GitHub 存储库源文件
+ 在 CodeCatalyst 工作流程中读取和执行 GitHub 操作
+ 将 CodeCatalyst 工作流程运行状态发送到链接 GitHub 仓库，并根据提交状态阻止 GitHub 拉取请求合并
### 将 Bitbucket 存储库 CodeCatalyst
Bitbucket 是一项基于云的服务，可帮助开发人员存储和管理他们的代码。**Bitbucket 存储库**扩展允许您在亚马逊 CodeCatalyst 项目中使用关联的 Bitbucket 存储库。您还可以在创建新 CodeCatalyst 项目时链接 Bitbucket 存储库。有关更多信息，请参阅 [使用链接的第三方存储库创建项目](projects-create.md#projects-create-3p-repo)。
**注意**
您不能在 CodeCatalyst 项目中使用空的或已存档的 Bitbucket 存储库。
**Bitbucket 存储库**扩展与 Bitbucket Data Center 存储库不兼容。
在安装和配置 **Bitbucket 存储库**扩展后，您将能够：
+ 在中的源存储库列表中查看您的 Bitbucket 存储库 CodeCatalyst
+ 在 Bitbucket 存储库中存储和管理工作流定义文件。
+ 在 CodeCatalyst 开发环境中创建、读取、更新和删除存储在链接 Bitbucket 存储库中的文件
+ 使用已连接 Bitbucket 账户的现有存储库创建 CodeCatalyst 项目
+ 将链接的 Bitbucket 存储库中的文件存储在中并为其编制索引 CodeCatalyst
+ 在使用蓝图创建项目或添加蓝图时，使用蓝图生成的代码创建 Bitbucket 存储库
+ 当代码被推送到链接的 Bitbucket 存储库时，或者在关联的 Bitbucket 存储库中创建、修改或关闭拉取请求时，启动 CodeCatalyst 工作流程会自动运行
+ 在工作流程中使用关联的 Bitbucket 存储库源文件 CodeCatalyst
+ 将 CodeCatalyst 工作流程运行状态发送到关联的 Bitbucket 存储库，并根据提交状态阻止 Bitbucket 拉取请求合并
### 将 GitLab 存储库集成到 CodeCatalyst
GitLab 是一项基于云的服务，可帮助开发人员存储和管理他们的代码。**GitLab 存储库**扩展允许您在 Amazon GitLab 项目中使用链接的 CodeCatalyst 项目存储库。您还可以在创建新 GitLab 项目时链接 CodeCatalyst 项目存储库。有关更多信息，请参阅 [使用链接的第三方存储库创建项目](projects-create.md#projects-create-3p-repo)。
**注意**
您不能将空的或已存档的 GitLab 项目存储库用于 CodeCatalyst 项目。
**GitLab 存储库**扩展与 GitLab 自行管理的存储库不兼容。
安装和配置**GitLab 存储库**扩展后，您将能够：
+ 在中的源存储库列表中查看您的 GitLab 项目存储库 CodeCatalyst
+ 在 GitLab 项目存储库中存储和管理工作流程定义文件。
+ 在 CodeCatalyst 开发环境中创建、读取、更新和删除存储在链接 GitLab 项目存储库中的文件
+ 使用已连接 GitLab 用户的现有存储库创建 CodeCatalyst 项目
+ 将链接的 GitLab 项目存储库中的文件存储在中并为其编制索引 CodeCatalyst
+ 使用蓝图创建 GitLab 项目或添加蓝图时，使用蓝图生成的代码创建项目存储库
+ 当代码被推送到链接的项目存储库时，或者在链接的 GitLab 项目存储库中创建、修改或关闭拉取请求时，启动 CodeCatalyst 工作流程会自动运行 GitLab
+ 在 CodeCatalyst 工作流程中使用链接的 GitLab 项目存储库源文件
+ 将 CodeCatalyst 工作流程运行状态发送到链接的 GitLab 项目存储库，并根据提交状态阻止 GitLab 合并请求
### 将 Jira 事务集成到 CodeCatalyst
Jira 是一款软件应用程序，可帮助敏捷开发团队计划、分配、跟踪、报告和管理工作。**Jira Softwar** e 扩展允许您在亚马逊 CodeCatalyst 项目中使用 Jira 项目。
**注意**
CodeCatalyst 仅与 **Jira Software Cloud** 兼容。
为亚马逊 CodeCatalyst 项目安装和配置 **Jira Softwar** e 扩展程序后，您将能够：
+ 通过将 Jira 项目链接到项目 CodeCatalyst 来访问这些项目 CodeCatalyst
+ 使用拉 CodeCatalyst 取请求更新 Jira 问题
+ 在 Jira 事务中查看关联 CodeCatalyst 拉取请求的状态和工作流程运行情况
# 扩展概念
以下是在中使用扩展时需要了解的一些概念和术语 CodeCatalyst。
## 扩展程序
*扩展程序*是一种附加组件，您可以将其安装到您的 CodeCatalyst 空间中，以便为项目添加新功能并与之外的服务集成 CodeCatalyst。可以从 CodeCatalyst 目录中浏览和安装扩展。
## CodeCatalyst 目录
该 CodeCatalyst 目录集中列出了中所有可用的扩展 CodeCatalyst。您可以浏览 CodeCatalyst 目录以查找可以改善团队在源代码、工作流程 CodeCatalyst 等领域的体验的扩展。
## 连接和链接
根据您要使用或管理的第三方资源，您需要关联 GitHub 账户、Bitbucket 工作空间或 Jira 项目。然后，你需要将你的 GitHub 存储库、Bitbucket 存储库或 Jira 项目链接到你的 CodeCatalyst 项目。
+ **GitHub 存储库**：Connect GitHub 帐户，然后关联 GitHub 存储库。
+ **Bitbucket 存储库**：连接 Bitbucket 工作区，然后链接 Bitbucket 存储库。
+ **GitLab 存储库**：连接 GitLab 用户，然后链接 GitLab 项目存储库。
+ **Jira Software**：连接 Jira 站点，然后链接 Jira 项目。
# 快速入门：安装扩展、连接提供商和链接资源 CodeCatalyst
本教程演练了以下三个任务：
1. 安装**GitHub 存储库**、**Bitbucket 存储**GitLab 库**、存储库**或 **Jira Software 扩展**程序。在外部站点中，系统会提示您连接并 CodeCatalyst 提供对第三方资源的访问权限，这将在下一步中完成。
**重要**
要将**GitHub 存储库**、**Bitbucket GitLab 存储库****、存储库**或 **Jira Softwar** e 扩展程序安装到您的 CodeCatalyst 空间，您必须使用在该空间中具有**空间管理员**角色的账户登录。
1. 将您的 GitHub 账户、Bitbucket 工作空间、 GitLab 用户或 Jira 网站连接到。 CodeCatalyst
**重要**
要将您的 GitHub 账户、Bitbucket 工作空间、 GitLab 用户或 Jira 站点连接到您的 CodeCatalyst 空间，您必须同时是第三方来源的管理员和 CodeCatalyst **空间**管理员。
**重要**
安装存储库扩展后，您链接到的任何存储库都 CodeCatalyst 将对其代码进行索引和存储。 CodeCatalyst这将使代码可在中 CodeCatalyst搜索。要更好地了解在中使用链接存储库时代码的数据保护 CodeCatalyst，请参阅 *Amazon CodeCatalyst 用户指南*中的[数据保护](https://docs.aws.amazon.com/codecatalyst/latest/userguide/data-protection.html)。
**注意**
如果您使用的是 GitHub 账户连接，则必须创建个人连接才能在您的身份和身份之间建立 CodeCatalyst 身份映射。 GitHub 有关更多信息，请参阅[个人连接](concepts.md#personal-connection-concept)和[通过人际关系访问 GitHub 资源](ipa-settings-connections.md)。
1. 将您的 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库或 Jira 项目链接到您的 CodeCatalyst 项目。
**重要**
虽然您可以作为**贡献者**链接 GitHub 存储库、Bitbucket 存储库或 GitLab 项目仓库，但您只能以 **Space 管理员或**项目**管理员**的身份取消第三方仓库的链接。有关更多信息，请参阅 [取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst](extensions-unlink.md)。
要将您的 Jira 项目链接到您的 CodeCatalyst 项目，您必须是 CodeCatalyst **Space 管理员**或 CodeCatalyst **项目管理员**。
**重要**
CodeCatalyst 不支持检测链接仓库的默认分支中的更改。要更改链接存储库的默认分支，必须先取消其与该分支的链接 CodeCatalyst，更改默认分支，然后再次进行链接。有关更多信息，请参阅 [在中关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst](extensions-link.md)。
作为最佳实践，在链接存储库之前，请始终确保您拥有最新版本的扩展。
**注意**
GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库只能链接到空间中的一个 CodeCatalyst 项目。
您不能将空仓库或已存档 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库与 CodeCatalyst 项目一起使用。
您不能链接与 GitLab 项目中 GitHub 仓库同名的存储库、Bitbucket 存储库或 CodeCatalyst 项目存储库。
**GitHub 存储库**扩展与 GitHub 企业服务器存储库不兼容。
**Bitbucket 存储库**扩展与 Bitbucket Data Center 存储库不兼容。
**GitLab 存储库**扩展与 GitLab 自行管理的项目存储库不兼容。
您无法在已链接存储库中使用**为我编写描述**或**汇总评论**功能。这些功能仅在中的拉取请求中可用 CodeCatalyst。
一个 CodeCatalyst 项目只能链接到一个 Jira 项目。一个 Jira 项目可以链接到多个 CodeCatalyst 项目。
创建新 CodeCatalyst 项目时，您还可以安装**GitHub 存储库**、**Bitbuck** et **GitLab 存储库、存储库**扩展、连接到您的 GitHub 账户、Bitbucket 工作空间或 GitLab 用户，以及链接第三方存储库。有关更多信息，请参阅 [使用链接的第三方存储库创建项目](projects-create.md#projects-create-3p-repo)。
**Topics**
+ [步骤 1：从 CodeCatalyst 目录中安装第三方扩展](#extensions-quickstart-install)
+ [第 2 步：将您的第三方提供商连接到您的 CodeCatalyst 空间](#extensions-github-extension-get-started-connect)
+ [第 3 步：将您的第三方资源链接到您的 CodeCatalyst 项目](#extensions-quickstart-link)
+ [后续步骤](#extensions-quickstart-next-steps)
## 步骤 1：从 CodeCatalyst 目录中安装第三方扩展
在中使用第三方资源的第一步 CodeCatalyst 是从目录中安装**GitHub 存储库**扩展。 CodeCatalyst 要安装扩展程序，请执行以下步骤，为要使用的第三方资源选择扩展程序。 **GitHub 存储库**、**Bitbucket 存储GitLab ****库和存储库**允许您在中使用 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库。 CodeCatalyst**Jira Softwar** e 允许您在中管理 Jira 问题。 CodeCatalyst
**从 CodeCatalyst 目录中安装扩展**
1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。
1. 导航到您的 CodeCatalyst 空间。
1. 通过选择顶部菜单![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/zh_cn/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png)中的**目录**图标来导航到目录。 CodeCatalyst CodeCatalyst 您可以搜索**GitHub 存储库、Bitbucket 存储GitLab **库******、存储库**或 **Jira So** ftware。您也可以根据类别筛选扩展。
1. （可选）要查看有关扩展的更多详细信息（例如扩展将具有的权限），请选择扩展名。
1. 选择**安装**。查看扩展所需的权限，如果要继续，请再次选择**安装**。
安装扩展后，您将进入扩展详细信息页面。根据已安装的扩展，您可以查看和管理连接的提供程序和链接的资源。
## 第 2 步：将您的第三方提供商连接到您的 CodeCatalyst 空间
安装**GitHub 存储库**、**Bitbucket 存储**GitLab 库**、存储**库或 **Jira Softwar** e 扩展程序后，下一步是将您的 GitHub 账户、Bitbucket 工作空间、 GitLab 项目存储库或 Jira 站点连接到您的空间。 CodeCatalyst
**将您的 GitHub 账户、Bitbucket 工作空间或 Jira 网站连接到 CodeCatalyst**
+ 根据已安装的第三方扩展，执行下列操作之一：
+ **GitHub 存储库**：Connect 连接到 GitHub 帐户。
1. 在 “**已连接的 GitHub 帐户**” 选项卡中，选择 **Connect GitHub 帐户**以转到外部站点 GitHub。
1. 使用您的 GitHub 凭证登录您的 GitHub 账户，然后选择要安装Amazon的账户 CodeCatalyst。
**提示**
如果您之前已将 GitHub 账户关联到该空间，则系统不会提示您重新授权。相反，如果您是多个组织的成员或合作者，则会看到一个对话框，询问您要在哪里安装扩展程序；如果您只属于一个 GitHub 组织，则会看到Amazon CodeCatalyst 应用程序的配置页面。 GitHub 为要允许的存储库访问权限配置应用程序，然后选择**保存**。如果**保存**按钮未激活，请更改配置，然后重试。
1. 选择是 CodeCatalyst 允许访问所有当前和将来的存储库，还是选择要在中使用的特定 GitHub 存储库 CodeCatalyst。默认选项是将 GitHub 账户中的所有 GitHub 存储库包括在内，包括将由访问的 future 存储库 CodeCatalyst。
1. 查看授予的权限 CodeCatalyst，然后选择 “**安装**”。
将您的 GitHub 账户关联到后 CodeCatalyst，系统会将您带到**GitHub 存储库**扩展详情页面，您可以在其中查看和管理关联的 GitHub 账户和关联的 GitHub 存储库。
+ **Bitbucket 存储库**：连接到 Bitbucket 工作区。
1. 在**已连接的 Bitbucket 工作区**选项卡中，选择**连接 Bitbucket 工作区**以转到 Bitbucket 的外部站点。
1. 使用您的 Bitbucket 凭据登录您的 Bitbucket 工作空间并查看授予的权限。 CodeCatalyst
1. 从 “**授权工作空间**” 下拉菜单中，选择要提供 CodeCatalyst 访问权限的 Bitbucket 工作空间，然后选择 “**授予访问权限**”。
**提示**
如果您之前已将 Bitbucket 工作区连接到空间，则系统不会提示您重新授权。相反，如果您是多个 Bitbucket 工作空间的成员或合作者，则会看到一个对话框，询问您要在哪里安装扩展程序；如果您只属于一个 Bitbucket 工作空间，则会看到亚马逊 CodeCatalyst 应用程序的配置页面。为要允许的工作区访问权限配置应用程序，然后选择**授予访问权限**。如果**授予访问权限**按钮未激活，请更改配置，然后重试。
将 Bitbucket 工作空间连接到后 CodeCatalyst，您将被带到 **Bitbucket 存储库**扩展详细信息页面，您可以在其中查看和管理已连接的 Bitbucket 工作空间和关联的 Bitbucket 存储库。
+ **GitLab 存储库**：Connect 连接到 GitLab 用户。
1. 选择 **Connect GitLab 用户**以访问外部站点 GitLab。
1. 使用您的 GitLab 证书登录您的 GitLab 用户并查看授予的权限 CodeCatalyst。
**提示**
如果您之前已将 GitLab 用户连接到空间，则系统不会提示您重新授权。相反，您将被导航回 CodeCatalyst 控制台。
1. 选择 “**为 AWS 连接器授权” GitLab**。
将 GitLab 用户连接到后 CodeCatalyst，系统会将您带到**GitLab 存储库**扩展详细信息页面，您可以在其中查看和管理关联的 GitLab 用户和关联的 GitLab 项目存储库。
+ **Jira Software**：连接 Jira 站点。
1. 在**已连接的 Jira 站点**选项卡中，选择**连接 Jira 站点**以转到 Atlassian Marketplace 的外部站点。
1. 选择 “**立即获取”，**开始在 Jira 网站上 CodeCatalyst 进行安装。
**注意**
如果您之前已安装 CodeCatalyst 到 Jira 站点，则会收到通知。选择**开始使用**以入最后一步。
1. 根据您的角色，请执行下列操作之一：
1. 如果您是 Jira 站点管理员，请从站点下拉菜单中选择要安装应用程序的 Jira 站点，然后选择**安装 CodeCatalyst **应用程序。
**注意**
如果您有一个 Jira 站点，则不会显示此步骤，系统会自动将您转到下一步。
1.
1. 如果您不是 Jira 管理员，请从站点下拉菜单中选择要安装应用程序的 Jira 站点，然后选择**请求 CodeCatalyst **应用程序。有关安装 Jira 应用程序的更多信息，请参阅 [Who can install apps?](https://www.atlassian.com/licensing/marketplace#who-can-install-apps)。
1. 在输入文本字段中 CodeCatalyst 输入需要安装的原因或保留默认文本，然后选择**提交请求**。
1. 查看安装应用程序 CodeCatalyst 时所执行的操作，然后选择 “**立即获取**”。
1. 安装应用程序后，选择 “**返回到**” CodeCatalyst 以返回到 CodeCatalyst。
将 Jira 站点连接到后 CodeCatalyst，您可以在 Jira So **f** tware 扩展详细信息页面的 “**已连接 Jira 站点**” 选项卡中查看已连接的站点。
## 第 3 步：将您的第三方资源链接到您的 CodeCatalyst 项目
使用您的 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库或在中管理 Jira 事务的第三步也是最后一步 CodeCatalyst 是将它们链接到您要在其中使用它的 CodeCatalyst 项目。
**从扩展详细信息页面将 GitHub 存储库、Bitbucket 存储库、项目存储库或 Jira CodeCatalyst 项目链接到项目 GitLab**
+ 根据已安装的第三方扩展和已连接的提供程序，执行下列操作之一：
+ **GitHub 存储库**：链接存储 GitHub 库。
1. 在 “**链接 GitHub 存储库**” 选项卡中，选择 “**链接 GitHub 存储库**”。
1. 从**GitHub 账户**下拉列表中，选择包含您要关联的存储库的 GitHub 账户。
1. 从**GitHub 存储库**下拉列表中，选择要链接到 CodeCatalyst 项目的存储库。
**提示**
如果存储库的名称已灰显，则无法链接该存储库，因为它已经链接到空间中的另一个项目。
1. （可选）如果您在 GitHub 存储库列表中看不到存储库，则可能未在的 Amazon CodeCatalyst 应用程序中将其配置为可以访问存储库 GitHub。您可以配置可在关联账户 CodeCatalyst 中使用哪些 GitHub 存储库。
1. 导航到您的[GitHub](https://github.com/)帐户，选择 “**设置”**，然后选择 “**应用程序**”。
1. 在 “**已安装的 GitHub 应用程序**” 选项卡中，为 Amazon CodeCatalyst 应用程序选择 “**配置**”。
1. 执行以下任一操作来配置要链接的 GitHub 存储库的访问权限 CodeCatalyst：
+ 要提供对所有当前和未来存储库的访问权限，请选择**所有存储库**。
+ 要提供对特定存储库的访问权限，**请选择 “仅选择存储****库”，选择 “**选择存储库” 下拉列表，然后选择要允许链接的存储库 CodeCatalyst。
1. 从**CodeCatalyst 项目**下拉菜单中，选择要将 GitHub 存储库链接到的 CodeCatalyst 项目。
1. 选择**链接**。
如果您不想再在中使用 GitHub 存储库 CodeCatalyst，可以取消它与 CodeCatalyst 项目的链接。解除存储库的链接后，该存储库中的事件将无法启动工作流程运行，并且您将无法在 CodeCatalyst 开发环境中使用该存储库。有关更多信息，请参阅 [取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst](extensions-unlink.md)。
+ **Bitbucket 存储库**：链接 Bitbucket 存储库。
1. 在**已链接的 Bitbucket 存储库**选项卡中，选择**链接 Bitbucket 存储库**。
1. 从 **Bitbucket 工作区**下拉菜单中，选择包含要链接的存储库的 Bitbucket 工作区。
1. 从 **Bitbucket 存储**库下拉列表中，选择要链接到 CodeCatalyst 项目的存储库。
**提示**
如果存储库的名称已灰显，则无法链接该存储库，因为它已经链接到空间中的另一个项目。
1. 从**CodeCatalyst 项目**下拉菜单中，选择要将 Bitbucket 存储库关联到的 CodeCatalyst 项目。
1. 选择**链接**。
如果您不想再在中使用 Bitbucket 存储库 CodeCatalyst，可以取消该存储库与项目的链接。 CodeCatalyst 解除存储库的链接后，该存储库中的事件将无法启动工作流程运行，并且您将无法在 CodeCatalyst 开发环境中使用该存储库。有关更多信息，请参阅 [取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst](extensions-unlink.md)。
+ **GitLab 存储库**：链接 GitLab 项目存储库。
1. 在 “**链接的 GitLab 项目存储库**” 选项卡中，选择 “**链接 GitLab 项目存储库**”。
1. 从**GitLab 用户**下拉列表中，选择包含要链接的存储库的 GitLab 用户。
1. 从**GitLab 项目存储库**下拉列表中，选择要链接到 CodeCatalyst 项目的存储库。
**提示**
如果存储库的名称已灰显，则无法链接该存储库，因为它已经链接到空间中的另一个项目。
1. 从**CodeCatalyst 项目**下拉菜单中，选择要将 CodeCatalyst 项目存储库链接到的 GitLab 项目。
1. 选择**链接**。
如果您不想再在中使用 GitLab 项目存储库 CodeCatalyst，则可以取消其与 CodeCatalyst 项目的链接。取消链接项目存储库后，该项目存储库中的事件将无法启动工作流程运行，并且您将无法在 CodeCatalyst 开发环境中使用该项目存储库。有关更多信息，请参阅 [取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst](extensions-unlink.md)。
+ **Jira Software**：链接 Jira 项目。
1. 在**已链接的 Jira 项目**选项卡中，选择**链接 Jira 项目**。
1. 从 **Jira 站点**下拉菜单中，选择包含要链接的项目的 Jira 站点。
1. 从 **Jira 项目**下拉菜单中，选择要链接到 CodeCatalyst 项目的项目。
1. 从**CodeCatalyst 项目**下拉菜单中，选择要链接到 Jira 项目的项目。 CodeCatalyst
1. 选择**链接**。
将 Jira 项目链接到 CodeCatalyst 项目后，将完全禁用对 CodeCatalyst 议题的访问权限， CodeCatalyst 导航窗格中的**议题**将被链接到 Jira 项目的 **Jira 议题**项所取代。
![\[CodeCatalyst 问题替换为导航窗格中的链接的 Jira 事务。\]](http://docs.aws.amazon.com/zh_cn/codecatalyst/latest/userguide/images/integrations/jira-issues-nav.png)
如果您不想再在中使用 Jira 项目 CodeCatalyst，可以取消其与项目的关联。 CodeCatalyst当 Jira 项目取消关联后，Jira 事务将不可用于该 CodeCatalyst项目，而 CodeCatalyst **问题**将再次成为议题提供者。有关更多信息，请参阅 [取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst](extensions-unlink.md)。
您还可以在 C **od** e 中将您的 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库链接到**源存储库**中的项目。有关更多信息，请参阅 [从已连接的第三方提供程序链接资源](extensions-link.md#extensions-link-resources)。
## 后续步骤
安装**GitHub 存储库**、**Bitbuck** et **GitLab 存储库或存储库**扩展、连接资源提供商并将第三方存储库与 CodeCatalyst 项目关联后，您可以在 CodeCatalyst 工作流程和开发环境中使用它。您还可以在关联的 GitHub 账户、Bitbucket 工作区或 GitLab 使用蓝图生成的代码的用户中创建第三方存储库。有关更多信息，请参阅[在第三方存储库事件发生后自动启动工作流运行](extensions-workflow-repositories.md)和[创建开发环境](devenvironment-create.md)。
安装 **Jira Software** 扩展程序、连接您的 Jira 站点、将 Jira 项目链接到您的 CodeCatalyst 项目以及关联拉取请求后，来自的更新将反映在您 CodeCatalyst 的 Jira 项目中。有关将拉取请求链接到 Jira 事务的更多信息，请参阅[将 Jira 事务与拉 CodeCatalyst 取请求相关联](link-jira-issues-pull-requests.md)。有关在 Jira 中查看 CodeCatalyst 事件的更多信息，请参阅[在 Jira 事务中查看 CodeCatalyst 事件](view-codecatalyst-events-jira.md)。
# 在空间中安装扩展
您可以为空间安装扩展，为该 CodeCatalyst 空间中的项目添加功能。您可以通过选择 CodeCatalyst 目录图标来查看**目录**![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/zh_cn/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png)。要了解有关扩展及其功能的更多信息，请参阅[可用的第三方扩展](extensions.md#extensions-types)。
**重要**
要安装扩展，您必须使用在空间中具有**空间管理员**角色的账户登录。
**重要**
安装存储库扩展后，您链接到的任何存储库都 CodeCatalyst 将对其代码进行索引和存储。 CodeCatalyst这将使代码可在中 CodeCatalyst搜索。要更好地了解在中使用链接存储库时代码的数据保护 CodeCatalyst，请参阅 *Amazon CodeCatalyst 用户指南*中的[数据保护](https://docs.aws.amazon.com/codecatalyst/latest/userguide/data-protection.html)。
**从 CodeCatalyst 目录中安装扩展**
1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。
1. 导航到您的 CodeCatalyst 空间。
1. 通过选择顶部菜单![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/zh_cn/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png)中的**目录**图标来导航到目录。 CodeCatalyst 您可以搜索**GitHub 存储库、Bitbucket 存储GitLab **库******、存储库**或 **Jira So** ftware。您也可以根据类别筛选扩展。
1. （可选）选择扩展的名称以查看有关扩展的更多详细信息（例如扩展将具有的权限）。
1. 选择**安装**。查看扩展所需的权限，如果要继续，请再次选择**安装**。
安装扩展后，您将看到已安装扩展的详细信息页面。浏览选项卡以查看有关扩展的更多信息。如果需要，您还可以在详细信息页面上进一步配置扩展。
# 卸载空间中的扩展
您可以卸载以前安装在您 CodeCatalyst 空间中的扩展程序。卸载扩展程序可能会从您的 CodeCatalyst 空间或项目中移除与该扩展程序相关的资源。
**重要**
要卸载扩展，您必须使用在空间中具有**空间管理员**角色的账户登录。
**从您的 CodeCatalyst 空间中卸载扩展程序**
1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。
1. 导航到您的 CodeCatalyst 空间。
1. 执行以下操作之一，以查看您空间已安装的扩展列表：
1. 选择**设置**，然后选择**已安装的扩展**。
1. 在顶部菜单中，选择**目录**图标 ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/zh_cn/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png)。
1. 在要卸载的扩展上选择**配置**。
1. 在扩展详细信息页面上选择**卸载**。
1. 查看**卸载扩展**对话框中的信息。按照说明进行操作，然后选择**卸载**来卸载扩展。
# 关联 GitHub 账户、Bitbucket 工作空间、 GitLab 用户和 Jira 站点 CodeCatalyst
要使用 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库或在中管理 Jira 项目 CodeCatalyst，必须先将第三方来源连接到您的 CodeCatalyst 空间。要了解有关扩展及其功能的更多信息，请参阅[可用的第三方扩展](extensions.md#extensions-types)。
**重要**
要将您的 GitHub 账户、Bitbucket 工作空间、 GitLab 用户或 Jira 站点连接到您的 CodeCatalyst 空间，您必须同时是第三方来源的管理员和 CodeCatalyst **空间**管理员。
**注意**
如果您使用的是 GitHub 账户连接，则必须创建个人连接才能在您的身份和身份之间建立 CodeCatalyst 身份映射。 GitHub 有关更多信息，请参阅[个人连接](concepts.md#personal-connection-concept)和[通过人际关系访问 GitHub 资源](ipa-settings-connections.md)。
**要将您的 GitHub 账户、Bitbucket 工作空间、 GitLab 用户或 Jira 网站连接到 CodeCatalyst**
1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。
1. 导航到您的 CodeCatalyst 空间。
1. 执行以下操作之一，以查看您空间已安装的扩展列表：
1. 选择**设置**，然后选择**已安装的扩展**。
1. 在顶部菜单中，选择**目录**图标 ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/zh_cn/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png)。
1. **为要**配置的以下扩展程序之一选择 “配置**”：**GitHub 存储库、Bitbucket 存储库****、存储库**或 **Jira So** ftware。GitLab **
1. 根据您选择配置的第三方扩展执行下列操作之一：
+ **GitHub 存储库**：Connect 连接到 GitHub 帐户。
1. 在 “**已连接的 GitHub 帐户**” 选项卡中，选择 **Connect GitHub 帐户**以转到外部站点 GitHub。
1. 使用您的 GitHub 凭证登录您的 GitHub 账户，然后选择要安装Amazon的账户 CodeCatalyst。
**提示**
如果您之前已将 GitHub 账户关联到该空间，则系统不会提示您重新授权。相反，如果您是多个空间的成员或合作者，则会看到一个对话框询问您要在哪里安装扩展程序；如果您只属于一个 GitHub 空间，则会看到Amazon CodeCatalyst 应用程序的配置页面。 GitHub 为要允许的存储库访问权限配置应用程序，然后选择**保存**。如果**保存**按钮未激活，请更改配置，然后重试。
1. 选择是 CodeCatalyst 允许访问所有当前和将来的存储库，还是选择要在中使用的特定 GitHub 存储库 CodeCatalyst。默认选项是将 GitHub 账户中的所有 GitHub 存储库包括在内，包括将由访问的 future 存储库 CodeCatalyst。
1. 查看授予的权限 CodeCatalyst，然后选择 “**安装**”。
将您的 GitHub 账户关联到后 CodeCatalyst，系统会将您带到**GitHub 存储库**扩展详情页面，您可以在其中查看和管理关联的 GitHub 账户和关联的 GitHub 存储库。
+ **Bitbucket 存储库**：连接到 Bitbucket 工作区。
1. 在**已连接的 Bitbucket 工作区**选项卡中，选择**连接 Bitbucket 工作区**以转到 Bitbucket 的外部站点。
1. 使用您的 Bitbucket 凭据登录您的 Bitbucket 工作空间并查看授予的权限。 CodeCatalyst
1. 从 “**授权工作空间**” 下拉菜单中，选择要提供 CodeCatalyst 访问权限的 Bitbucket 工作空间，然后选择 “**授予访问权限**”。
**提示**
如果您之前已将 Bitbucket 工作区连接到空间，则系统不会提示您重新授权。相反，如果您是多个 Bitbucket 工作空间的成员或合作者，则会看到一个对话框，询问您要在哪里安装扩展程序；如果您只属于一个 Bitbucket 工作空间，则会看到亚马逊 CodeCatalyst 应用程序的配置页面。为要允许的工作区访问权限配置应用程序，然后选择**授予访问权限**。如果**授予访问权限**按钮未激活，请更改配置，然后重试。
将 Bitbucket 工作空间连接到后 CodeCatalyst，您将被带到 **Bitbucket 存储库**扩展详细信息页面，您可以在其中查看和管理已连接的 Bitbucket 工作空间和关联的 Bitbucket 存储库。
+ **GitLab 存储库**：Connect 连接到 GitLab 用户。
1. 选择 **Connect GitLab 用户**以访问外部站点 GitLab。
1. 使用您的 GitLab 证书登录您的 GitLab 用户并查看授予的权限 CodeCatalyst。
**提示**
如果您之前已将 GitLab 用户连接到空间，则系统不会提示您重新授权。相反，您将被导航回 CodeCatalyst 控制台。
1. 选择 “**为 AWS 连接器授权” GitLab**。
将 GitLab 用户连接到后 CodeCatalyst，系统会将您带到**GitLab 存储库**扩展详细信息页面，您可以在其中查看和管理关联的 GitLab 用户和关联的 GitLab 项目存储库。
+ **Jira Software**：连接 Jira 站点。
1. 在**已连接的 Jira 站点**选项卡中，选择**连接 Jira 站点**以转到 Atlassian Marketplace 的外部站点。
1. 选择 “**立即获取”，**开始在 Jira 网站上 CodeCatalyst 进行安装。
**注意**
如果您之前已安装 CodeCatalyst 到 Jira 站点，则会收到通知。选择**开始使用**以入最后一步。
1. 根据您的角色，请执行下列操作之一：
1. 如果您是 Jira 站点管理员，请从站点下拉菜单中选择要安装应用程序的 Jira 站点，然后选择**安装 CodeCatalyst **应用程序。
**注意**
如果您有一个 Jira 站点，则不会显示此步骤，系统会自动将您转到下一步。
1.
1. 如果您不是 Jira 管理员，请从站点下拉菜单中选择要安装应用程序的 Jira 站点，然后选择**请求 CodeCatalyst **应用程序。有关安装 Jira 应用程序的更多信息，请参阅 [Who can install apps?](https://www.atlassian.com/licensing/marketplace#who-can-install-apps)。
1. 在输入文本字段中 CodeCatalyst 输入需要安装的原因或保留默认文本，然后选择**提交请求**。
1. 查看安装应用程序 CodeCatalyst 时所执行的操作，然后选择 “**立即获取**”。
1. 安装应用程序后，选择 “**返回到**” CodeCatalyst 以返回到 CodeCatalyst。
将 Jira 站点连接到后 CodeCatalyst，您可以在 Jira So **f** tware 扩展详细信息页面的 “**已连接 Jira 站点**” 选项卡中查看已连接的站点。
如果您不想再使用 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库，也不想在中管理 Jira 事务 CodeCatalyst，则可以断开第三方来源的连接。当 GitHub 账户、Bitbucket 工作空间或 GitLab 用户断开连接时，第三方存储库中的事件将无法启动工作流程运行，并且您将无法在 CodeCatalyst 开发环境中使用这些存储库。当 Jira 站点断开连接时，来自该站点项目的 Jira 事务将无法在 CodeCatalyst 项目中使用，而 CodeCatalyst **问题将再次**成为议题提供者。有关更多信息，请参阅 [断开 GitHub 账户、Bitbucket 工作空间、 GitLab 用户和 Jira 网站的连接 CodeCatalyst](extensions-disconnect.md)。
# 断开 GitHub 账户、Bitbucket 工作空间、 GitLab 用户和 Jira 网站的连接 CodeCatalyst
如果您不想再使用 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库，也不想在中管理 Jira 事务 CodeCatalyst，则可以断开第三方来源的连接。一旦 GitHub 账户、Bitbucket 工作空间或 GitLab 用户断开连接，存储库中的事件将无法启动工作流程运行，并且您将无法在 CodeCatalyst 开发环境中使用这些存储库。当 Jira 站点断开连接时，来自该站点项目的 Jira 事务将无法在 CodeCatalyst 项目中使用，而 CodeCatalyst **问题将再次**成为议题提供者。
**注意**
要断开 GitHub 账户的连接，必须先取消所有关联 GitHub 仓库与该账户的关联。
要断开某个 Bitbucket 工作区的连接，您必须先取消所有链接的 Bitbucket 存储库与该工作区的链接。
要断开 GitLab 用户的连接，必须先取消所有链接的 GitLab 项目存储库与该工作区的链接。
要断开某个 Jira 站点的连接，必须先取消所有链接的 Jira 项目与该账户的链接。
有关更多信息，请参阅 [取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst](extensions-unlink.md)。
**断开 GitHub 项目、Bitbucket 工作空间、 GitLab 用户或 Jira 网站的连接**
1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。
1. 导航到您的 CodeCatalyst 空间。
1. 执行以下操作之一，以查看您空间已安装的扩展列表：
1. 选择**设置**，然后选择**已安装的扩展**。
1. 在顶部菜单中，选择**目录**图标 ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/zh_cn/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png)。
1. **为要**配置的以下扩展程序之一选择 “配置**”：**GitHub 存储库、Bitbucket 存储库****、存储库**或 **Jira So** ftware。GitLab **
1. 根据您选择配置的第三方扩展执行下列操作之一：
+ **GitHub 存储库**：断开与帐户的连接。 GitHub
在 “**已连接的 GitHub 帐户**” 选项卡中，选择要断开连接的 GitHub 帐户，然后选择 “**断开 GitHub 帐户**”。
+ **Bitbucket 存储库**：断开与 Bitbucket 工作区的连接。
在**已连接的 Bitbucket 工作区**选项卡中，选择要断开连接的 Bitbucket 工作区，然后选择**断开 Bitbucket 工作区的连接**。
+ **GitLab 存储库**：断开与用户的连接。 GitLab
在 “**已连接的 GitLab 用户**” 选项卡中，选择要断开连接的 GitLab 用户，然后选择 “**断开 GitLab 用户连接**”。
+ **Jira Software**：断开与 Jira 站点的连接。
在**已连接的 Jira 站点**选项卡中，选择要断开连接的 Jira 站点，然后选择**断开 Jira 站点的连接**。
1. 在**断开连接**对话框中，查看断开账户的连接所带来的影响。
1. 在文本输入字段中输入 **disconnect**，然后选择**断开连接**。
# 在中关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst
在使用 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库或管理 Jira 项目之前，必须将存储库或项目所属的第三方源与您的 CodeCatalyst 空间连接起来。有关更多信息，请参阅 [关联 GitHub 账户、Bitbucket 工作空间、 GitLab 用户和 Jira 站点 CodeCatalyst](extensions-connect.md)。
您可以在工作流程中使用链接 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库，其中链接存储库中的事件会启动可能构建、测试或部署代码的工作流程，具体取决于工作流程配置。使用链接存储库 GitHub 或 Bitbucket 存储库的工作流程配置文件存储在链接存储库中。此外，可以将已链接存储库与开发环境结合使用，来创建、更新和删除已链接存储库中的文件。**您可以从 GitHub 存储库、Bitbucket 存储库或 GitLab 存储库扩展的详细信息页面，或者从 CodeCatalyst 项目本身的 “**代码**” 中的 “**源**存储库” 视图将**GitLab 存储库**、Bitbuck** et 存储库**或项目存储库链接到项目。GitHub **
**重要**
虽然您可以以**贡献者的**身份链接 GitHub 或 Bitbucket 存储库，但您只能以 **Space 管理员或**项目**管理员**的身份取消第三方仓库的链接。有关更多信息，请参阅 [取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst](extensions-unlink.md)。
**重要**
安装存储库扩展后，您链接到的任何存储库都 CodeCatalyst 将对其代码进行索引和存储。 CodeCatalyst这将使代码可在中 CodeCatalyst搜索。要更好地了解在中使用链接存储库时代码的数据保护 CodeCatalyst，请参阅 *Amazon CodeCatalyst 用户指南*中的[数据保护](https://docs.aws.amazon.com/codecatalyst/latest/userguide/data-protection.html)。
**重要**
CodeCatalyst 不支持检测链接仓库的默认分支中的更改。要更改链接存储库的默认分支，必须先取消其与该分支的链接 CodeCatalyst，更改默认分支，然后再次进行链接。
作为最佳实践，在链接存储库之前，请始终确保您拥有最新版本的扩展。
您可以使用关联的 Jira 项目来管理议题并将 CodeCatalyst 拉取请求链接到 Jira 事务。拉取请求的摘要状态和关联 CodeCatalyst 的工作流事件的状态会反映在您的 Jira 事务中。
**重要**
要将您的 Jira 项目链接到您的 CodeCatalyst 项目，您必须是 CodeCatalyst **Space 管理员**或 CodeCatalyst **项目管理员**。
**注意**
GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库只能链接到空间中的一个 CodeCatalyst 项目。
您不能将空仓库或已存档 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库与 CodeCatalyst 项目一起使用。
您不能链接与 CodeCatalyst 项目中 GitHub 仓库同名的存储库、Bitbucket 存储库或 GitLab 存储库。
**GitHub 存储库**扩展与 GitHub 企业服务器存储库不兼容。
**Bitbucket 存储库**扩展与 Bitbucket Data Center 存储库不兼容。
**GitLab 存储库**扩展与 GitLab 自行管理的项目存储库不兼容。
您无法在已链接存储库中使用**为我编写描述**或**汇总评论**功能。这些功能仅在中的拉取请求中可用 CodeCatalyst。
一个 CodeCatalyst 项目只能链接到一个 Jira 项目。一个 Jira 项目可以链接到多个 CodeCatalyst 项目。
**Topics**
+ [从已连接的第三方提供程序链接资源](#extensions-link-resources)
+ [在 CodeCatalyst 项目创建过程中将第三方存储库链接到](#extensions-link-repositories-creation)
## 从已连接的第三方提供程序链接资源
**从扩展详细信息页面将 GitHub 存储库、Bitbucket 存储库、项目存储库或 Jira CodeCatalyst 项目链接到项目 GitLab**
1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。
1. 导航到您的 CodeCatalyst 空间。
1. 执行以下操作之一，以查看您空间已安装的扩展列表：
1. 选择**设置**，然后选择**已安装的扩展**。
1. 在顶部菜单中，选择**目录**图标 ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/zh_cn/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png)。
1. 为以下扩展程序之一选择 “**配置**”：**GitHub 存储库**、**Bitbucket 存储**GitLab 库**、存储库**或 **Jira So** ftware。
1. 根据您选择配置的第三方扩展执行下列操作之一：
+ **GitHub 存储库**：链接存储 GitHub 库。
1. 在 “**链接 GitHub 存储库**” 选项卡中，选择 “**链接 GitHub 存储库**”。
1. 从**GitHub 账户**下拉列表中，选择包含您要关联的存储库的 GitHub 账户。
1. 从**GitHub 存储库**下拉列表中，选择要链接到 CodeCatalyst 项目的存储库。
**提示**
如果存储库的名称已灰显，则无法链接该存储库，因为它已经链接到空间中的另一个项目。
1. （可选）如果您在 GitHub 存储库列表中看不到存储库，则可能未在的 Amazon CodeCatalyst 应用程序中将其配置为可以访问存储库 GitHub。您可以配置可在关联账户 CodeCatalyst 中使用哪些 GitHub 存储库。
1. 导航到您的[GitHub](https://github.com/)帐户，选择 “**设置”**，然后选择 “**应用程序**”。
1. 在 “**已安装的 GitHub 应用程序**” 选项卡中，选择 Amazon CodeCatalyst 应用程序的 “**配置**”。
1. 执行以下任一操作来配置要链接的 GitHub 存储库的访问权限 CodeCatalyst：
+ 要提供对所有当前和未来存储库的访问权限，请选择**所有存储库**。
+ 要提供对特定存储库的访问权限，**请选择 “仅选择存储****库”，选择 “**选择存储库” 下拉列表，然后选择要允许链接的存储库 CodeCatalyst。
1. 从**CodeCatalyst 项目**下拉菜单中，选择要将 GitHub 存储库链接到的 CodeCatalyst 项目。
1. 选择**链接**。
如果您不想再在中使用 GitHub 存储库 CodeCatalyst，可以取消它与 CodeCatalyst 项目的链接。解除存储库的链接后，该存储库中的事件将无法启动工作流程运行，并且您将无法在 CodeCatalyst 开发环境中使用该存储库。有关更多信息，请参阅 [取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst](extensions-unlink.md)。
+ **Bitbucket 存储库**：链接 Bitbucket 存储库。
1. 在**已链接的 Bitbucket 存储库**选项卡中，选择**链接 Bitbucket 存储库**。
1. 从 **Bitbucket 工作区**下拉菜单中，选择包含要链接的存储库的 Bitbucket 工作区。
1. 从 **Bitbucket 存储**库下拉列表中，选择要链接到 CodeCatalyst 项目的存储库。
**提示**
如果存储库的名称已灰显，则无法链接该存储库，因为它已经链接到空间中的另一个项目。
1. 从**CodeCatalyst 项目**下拉菜单中，选择要将 Bitbucket 存储库关联到的 CodeCatalyst 项目。
1. 选择**链接**。
如果您不想再在中使用 Bitbucket 存储库 CodeCatalyst，可以取消该存储库与项目的链接。 CodeCatalyst 解除存储库的链接后，该存储库中的事件将无法启动工作流程运行，并且您将无法在 CodeCatalyst 开发环境中使用该存储库。有关更多信息，请参阅 [取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst](extensions-unlink.md)。
+ **GitLab 存储库**：链接 GitLab 项目存储库。
1. 在 “**链接的 GitLab 项目存储库**” 选项卡中，选择 “**链接 GitLab 项目存储库**”。
1. 从**GitLab 用户**下拉列表中，选择包含要链接的项目存储库的 GitLab 用户。
1. 从**GitLab 项目存储库**下拉列表中，选择要链接到 CodeCatalyst 项目的存储库。
**提示**
如果存储库的名称已灰显，则无法链接该存储库，因为它已经链接到空间中的另一个项目。
1. 从**CodeCatalyst 项目**下拉菜单中，选择要将 CodeCatalyst 项目存储库链接到的 GitLab 项目。
1. 选择**链接**。
如果您不想再在中使用 GitLab 项目存储库 CodeCatalyst，则可以取消其与 CodeCatalyst 项目的链接。取消链接项目存储库后，该项目存储库中的事件将无法启动工作流程运行，并且您将无法在 CodeCatalyst 开发环境中使用该项目存储库。有关更多信息，请参阅 [取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst](extensions-unlink.md)。
+ **Jira Software**：链接 Jira 项目。
1. 在**已链接的 Jira 项目**选项卡中，选择**链接 Jira 项目**。
1. 从 **Jira 站点**下拉菜单中，选择包含要链接的项目的 Jira 站点。
1. 从 **Jira 项目**下拉菜单中，选择要链接到 CodeCatalyst 项目的项目。
1. 从**CodeCatalyst 项目**下拉菜单中，选择要链接到 Jira 项目的项目。 CodeCatalyst
1. 选择**链接**。
将 Jira 项目链接到 CodeCatalyst 项目后，将完全禁用对 CodeCatalyst 议题的访问权限， CodeCatalyst 导航窗格中的**议题**将被链接到 Jira 项目的 **Jira 议题**项所取代。
![\[CodeCatalyst 问题替换为导航窗格中的链接的 Jira 事务。\]](http://docs.aws.amazon.com/zh_cn/codecatalyst/latest/userguide/images/integrations/jira-issues-nav.png)
如果您不想再在中使用 Jira 项目 CodeCatalyst，可以取消其与项目的关联。 CodeCatalyst当 Jira 项目取消关联后，Jira 事务将不可用于该 CodeCatalyst项目，而 CodeCatalyst **问题**将再次成为议题提供者。有关更多信息，请参阅 [取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst](extensions-unlink.md)。
**从项目的源 GitHub 存储库页面将存储库、Bitbucket 存储库或 GitLab CodeCatalyst 项目存储库链接到项目**
1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。
1. 导航到您的 CodeCatalyst 项目。
1. 在导航窗格中，选择**代码**，然后选择**源存储库**。
1. 选择**添加存储库**，然后选择**链接存储库**。
1. 从**存储库提供商**下拉菜单中，选择以下第三方存储库提供商之一：**GitHub**、**Bitbucket**、**GitLab**。
1. 根据您已选择链接的第三方存储库提供程序，执行下列操作之一：
+ **GitHub 存储库**：链接存储 GitHub 库。
1. 从**GitHub 账户**下拉菜单中，选择包含您要关联的存储库的 GitHub 账户。
1. 从**GitHub 存储库**下拉菜单中，选择要链接 CodeCatalyst 项目的 GitHub 存储库。
**提示**
如果存储库的名称显示为灰色，则无法链接该存储库，因为它已经链接到 Amazon CodeCatalyst 中的另一个项目。
1. （可选）如果您在 GitHub 存储库列表中看不到存储库，则可能未在的 Amazon CodeCatalyst 应用程序中将其配置为可以访问存储库 GitHub。您可以配置可在关联账户 CodeCatalyst 中使用哪些 GitHub 存储库。
1. 导航到您的[GitHub](https://github.com/)帐户，选择 “**设置”**，然后选择 “**应用程序**”。
1. 在 “**已安装的 GitHub 应用程序**” 选项卡中，选择 Amazon CodeCatalyst 应用程序的 “**配置**”。
1. 执行以下任一操作来配置要链接的 GitHub 存储库的访问权限 CodeCatalyst：
+ 要提供对所有当前和未来存储库的访问权限，请选择**所有存储库**。
+ 要提供对特定存储库的访问权限，**请选择 “仅选择存储****库”，选择 “**选择存储库” 下拉列表，然后选择要允许链接的存储库 CodeCatalyst。
+ **Bitbucket 存储库**：链接 Bitbucket 存储库。
1. 从 **Bitbucket 工作区**下拉菜单中，选择包含要链接的存储库的 Bitbucket 工作区。
1. 从 **Bitbucket 存储库**下拉菜单中，选择要关联项目的 Bitbucket 存储库。 CodeCatalyst
**提示**
如果存储库的名称显示为灰色，则无法链接该存储库，因为它已经链接到 Amazon CodeCatalyst 中的另一个项目。
+ **GitLab 存储库**：链接 GitLab 项目存储库。
1. 从**GitLab 用户**下拉菜单中，选择包含要链接的项目存储库的 GitLab 用户。
1. 从**GitLab 项目存储库**下拉菜单中，选择要链接 CodeCatalyst 项目的项目存储库。 GitLab
**提示**
如果项目存储库的名称显示为灰色，则无法链接该项目存储库，因为它已经链接到 Amazon CodeCatalyst 中的另一个项目。
1. 选择**链接**。
如果您不想再在中使用 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库 CodeCatalyst，则可以取消其与项目的链接。 CodeCatalyst 解除存储库的链接后，该存储库中的事件将无法启动工作流程运行，并且您将无法在 CodeCatalyst 开发环境中使用该存储库。有关更多信息，请参阅 [取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst](extensions-unlink.md)。
将您的 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库链接到您的 CodeCatalyst 项目后，您可以在 CodeCatalyst 工作流程和开发环境中使用它。您还可以将已链接存储库与 Amazon Q 开发者版、蓝图等结合使用。有关更多信息，请参阅[在第三方存储库事件发生后自动启动工作流运行](extensions-workflow-repositories.md)和[创建开发环境](devenvironment-create.md)。
将 Jira 项目与项目关联并关联拉取请求后，来自的更新将反映在您 CodeCatalyst 的 Jira CodeCatalyst 项目中。有关将拉取请求链接到 Jira 事务的更多信息，请参阅[将 Jira 事务与拉 CodeCatalyst 取请求相关联](link-jira-issues-pull-requests.md)。有关在 Jira 中查看 CodeCatalyst 事件的更多信息，请参阅[在 Jira 事务中查看 CodeCatalyst 事件](view-codecatalyst-events-jira.md)。
## 在 CodeCatalyst 项目创建过程中将第三方存储库链接到
在创建新项目时，您可以将存储 GitHub 库、Bitbucket 存储库或 GitLab 项目存储库链接到新 CodeCatalyst 项目。 CodeCatalyst 有关更多信息，请参阅 [使用链接的第三方存储库创建项目](projects-create.md#projects-create-3p-repo)。
# 取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst
如果您不想再使用 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库，也不想在中管理 Jira 项目 CodeCatalyst，则可以取消该存储库或项目与项目的链接。 CodeCatalyst
取消关联 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库不会删除存储库或对其进行任何更改。这不会删除存储在该已链接的存储库中的任何工作流配置文件。但是，一旦您取消了 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库的链接，该存储库中的事件将不再启动工作流程运行，并且您也无法在开发环境中使用该存储库。您可以从 GitHub 存储库、Bitbucket 存储库或 GitLab 存储库扩展的详细信息页面，或者从 CodeCatalyst 项目本身的 “**代码**” 中的 “**源**GitHub 存储库**” 视图中取消项目**GitLab 仓库****、Bitbuck** et 存储库**或项目存储库的链接。
取消链接 Jira 项目不会删除该项目，包括计划项目或开发信息，也不会对其进行任何更改。但是，解除与 Jira 项目的关联后，该项目的 Jira 事务将无法再链接到该 CodeCatalyst 项目， CodeCatalyst **问题**将再次成为议题提供者。
**重要**
**要取消存储 GitHub 库、Bitbucket 存储库或 Gitlab 项目存储库与 CodeCatalyst 项目的关联，您必须是 **Space 管理员**或项目管理员。**
**取消项目中 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库或 Jira 项目与扩展详细信息 CodeCatalyst 页面的关联**
1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。
1. 导航到您的 CodeCatalyst 空间。
1. 执行以下操作之一，以查看您空间已安装的扩展列表：
1. 选择**设置**，然后选择**已安装的扩展**。
1. 在顶部菜单中，选择**目录**图标 ![\[The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst.\]](http://docs.aws.amazon.com/zh_cn/codecatalyst/latest/userguide/images/integrations/marketplace-icon.png)。
1. **为要**配置的以下扩展程序之一选择 “配置**”：**GitHub 存储库、Bitbucket 存储库****、存储库**或 **Jira So** ftware。GitLab **
1. 根据您选择配置的第三方扩展执行下列操作之一：
+ **GitHub 存储库**：取消存储 GitHub 库的链接。
在 “**GitHub 存储库**” 选项卡中，选择要取消链接的 GitHub 存储库，然后选择 “**取消链接 GitHub **存储库”。
+ **Bitbucket 存储库**：取消链接 Bitbucket 存储库。
在 **Bitbucket 存储库**选项卡中，选择要取消链接的 Bitbucket 存储库，然后选择**取消链接 Bitbucket 存储库**。
+ **GitLab 存储库**：取消 GitLab 项目存储库的链接。
在 “**GitLab 项目存储库**” 选项卡中，选择要取消链接的 GitLab 项目存储库，然后选择 “**取消链接 GitLab 项目**存储库”。
+ **Jira Software**：取消链接 Jira 项目。
在 **Jira 项目**选项卡中，选择要取消链接的 Jira 项目，然后选择**取消链接 Jira 项目**。
1. 在**取消链接**对话框中，查看取消链接存储库所带来的影响。
1. 在文本输入字段中输入 **unlink**，然后选择**取消链接**。
**从源存储库页面取消项目中存储 GitHub 库、Bitbucket 存储库或 GitLab CodeCatalyst 项目存储库的链接**
1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。
1. 导航到您的 CodeCatalyst 项目。
1. 在导航窗格中，选择**代码**，然后选择**源存储库**。
1. 选择要取消链接的存储库的单选按钮，然后选择**取消链接存储库**。
1. 查看对话框中的信息。按照说明进行操作，然后选择**取消链接**以取消存储库的链接。
# 在中查看第三方存储库并搜索 Jira 事务 CodeCatalyst
关联 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库后，您可以在中查看它们 CodeCatalyst 以确认和配置资源。您也可以在中搜索关联的 Jira 事务。 CodeCatalyst
**Topics**
+ [在中查看第三方存储库 CodeCatalyst](#extensions-view-repositories)
+ [在中搜索 Jira 问题 CodeCatalyst](#extensions-search-issues)
## 在中查看第三方存储库 CodeCatalyst
您可以在 GitLab 项目的源存储库列表中或从存储 GitHub 库、Bitbucket 存储库或存储库扩展详细信息页面查看链接**GitHub 存储库**、**Bitbucket 存储库**或项目**GitLab 存储库**。从存储库列表中选择它们并不能在中打开它们 CodeCatalyst。相反，它们在第三方存储库提供程序中打开，您可以在其中查看和处理已链接的存储库中的代码。
**要在中查看链接的 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库 CodeCatalyst**
1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。
1. 导航到您的 CodeCatalyst 项目。
1. 在导航窗格中，选择**代码**，然后选择**源存储库**。
**从扩展详情页面查看链接的存储 GitHub 库、Bitbucket 存储库或 GitLab 项目存储库**
1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。
1. 导航到您的 CodeCatalyst 空间，然后选择 “**已安装的扩展**” 选项卡。
1. 根据要查看的第三方存储库，执行下列操作之一：
+ 在**GitHub 存储库**中，选择 “**配置**”，然后选择 “**链接 GitHub 存储库**”，查看与 CodeCatalyst 空间中 CodeCatalyst 项目关联的所有 GitHub 存储库。
+ 在 **Bitbucket 存储库**中，选择 “**配置**”，然后选择 “**关联的 Bitbucket 存储库**”，查看与您空间中 CodeCatalyst 项目关联的所有 Bitbucket 存储库。 CodeCatalyst
+ 在**GitLab 存储库**中，选择 “**配置**”，然后选择 “**链接的 GitLab 项目存储库**”，以查看与 CodeCatalyst 空间中 CodeCatalyst 项目关联的所有 GitLab 项目存储库。
列表中显示了链接到您的 GitLab 项目的存储 GitHub 库、Bitbucket 存储库或 CodeCatalyst 项目存储库。选择 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库以查看和编辑第三方存储库提供商中的文件。
**注意**
如果工作流程在源操作中使用 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库，则您在可视化编辑器或 YAML 编辑器中对工作流程 YAML 所做的更改 CodeCatalyst 将自动提交并推送到第三方存储库。
## 在中搜索 Jira 问题 CodeCatalyst
关联 Jira 项目后，您可以使用 CodeCatalyst 全局搜索栏在链接的 Jira 项目中搜索问题。您还可以在中搜索 Jira 事务， CodeCatalyst 同时链接到拉取请求中的事务。有关将 Jira 事务与拉 CodeCatalyst 取请求关联的更多信息，请参阅[将 Jira 事务与拉 CodeCatalyst 取请求相关联](link-jira-issues-pull-requests.md)。
**在已链接的 Jira 项目中搜索 Jira 事务**
1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。
1. 导航到您的 CodeCatalyst 项目。
1. 在全局搜索栏中，在已链接的 Jira 项目中搜索要链接到拉取请求的事务或 Jira 事务。
# 在第三方存储库事件发生后自动启动工作流运行
您可以使用链接 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)。
## 添加触发器以启动工作流运行
您可以将 CodeCatalyst 工作流程配置为在将代码推送到您 GitHub 或 Bitbucket 存储库的指定分支时自动开始运行。要自动启动工作流运行，请在工作流配置文件的 `Triggers` 部分中添加触发器。
### 示例：一个简单的代码推送触发器
以下示例显示了一个触发器，在代码被推送到源存储库中的任何分支时，该触发器将启动工作流运行。
```
Triggers:
- Type: PUSH
```
### 示例：一个简单的拉取请求触发器
以下示例显示了一个触发器，在针对源存储库中的任何分支创建拉取请求时，该触发器将启动工作流运行。
```
Triggers:
- Type: PULLREQUEST
Events:
- OPEN
```
有关更多信息，请参阅 [使用触发器自动启动工作流运行](workflows-add-trigger.md)。
# 限制第三方存储库提供程序的 IP 访问权限
您可以通过设置规则或配置，根据 IP 地址限制对存储 GitHub 库、Bitbucket 存储库或 GitLab 项目存储库的访问权限。您可以通过第三方提供程序的设置或访问控制功能来执行此操作。
根据您使用的第三方存储库提供程序，请参阅下列内容之一：
+ Amazon CodeCatalyst **GitHub 存储库**扩展与[ GitHub 企业云 IP 访问限制](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization)兼容。在将 E GitHub nterprise Cloud 组织配置为限制[对特定 IP 地址的访问时，您还可以允许 GitHub 应用程序配置允许列表](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps)，允许自动 CodeCatalyst 注册其 IP 地址 GitHub。或者，您可以[手动添加 CodeCatalyst IP 地址](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address)。
+ 亚马逊 CodeCatalyst **Bitbucket 存储库**扩展与 [Bitbucket 云高级版访问限制](https://support.atlassian.com/bitbucket-cloud/docs/control-access-to-your-private-content/)兼容。在配置 Bitbucket Cloud Premium 工作区以限制对特定 IP 地址的访问时，您还可以 [add IP addresses or network blocks for a set of IP addresses to an allowlist](https://support.atlassian.com/bitbucket-cloud/docs/control-access-to-your-private-content/#Allowlisting-IP-addresses)。
+ Amazon CodeCatalyst **GitLab 存储库**扩展与 [ GitLab IP 地址限制](https://docs.gitlab.com/ee/administration/reporting/ip_addr_restrictions.html)兼容。在配置 GitLab 高级或旗舰版组以限制对特定 IP 地址的访问时，您还可以[将一组 IP 地址的 IP 地址或网络块添加到许可名单中](https://docs.gitlab.com/ee/user/group/access_and_permissions.html)。
如果 CodeCatalyst IP 地址不在第三方存储库的许可名单中，Amazon CodeCatalyst 应用程序将无法访问您的第三方存储库。有关更多信息，请参阅 [第三方存储库扩展使用的 IP 地址](#codecatalyst-ip-address)。
## 第三方存储库扩展使用的 IP 地址
第三方扩展使用以下 IP 地址访问您的第三方资源：
+ **GitHub 存储库**：
```
us-west-2
52.32.242.246
54.148.176.49
35.164.118.94
eu-west-1
34.241.64.10
34.246.255.80
3.248.38.7
```
+ **比特存储库和存储GitLab ****库**：
```
us-west-2
35.160.210.199
54.71.206.108
54.71.36.205
eu-west-1
34.242.64.82
52.18.37.201
54.77.75.62
```
# 在工作流失败时阻止第三方合并
将 GitHub 或 Bitbucket 存储库关联到后 CodeCatalyst，您可以为拉取请求添加 CodeCatalyst 工作流程。同样，在将 GitLab 项目存储库链接到之后， CodeCatalyst 您可以为合并请求添加 CodeCatalyst 工作流程。在一次特定的提交中可以运行一个或多个工作流程，并且中每个工作流程的运行状态 CodeCatalyst 也反映在 GitHub、Bitbucket 或 GitLab中的提交状态中。推送新提交时，新的工作流程[运行状态](https://docs.aws.amazon.com/codecatalyst/latest/userguide/workflows-view-run.html#workflows-view-run-status)将反映在 GitHub、Bitbucket 或 GitLab 该新提交中。如果您再次为提交运行工作流，则新的工作流运行状态将覆盖该提交和工作流的上一个状态。
您可以在 GitHub 或 Bitbucket 中设置分支保护规则以阻止拉取请求合并，或者在 GitLab 最新提交的工作流程运行状态为失败时阻止合并请求。使用分支保护规则，最新提交的状态会影响在、Bitbucket 或 GitLab中 GitHub合并拉取请求的能力。要了解有关工作流的更多信息，请参阅[运行工作流](workflows-working-runs.md)和[使用触发器自动启动工作流运行](workflows-add-trigger.md)。
根据您使用的第三方存储库提供商，请参阅以下内容：
+ **GitHub 存储库**： GitHub的文档[关于状态检查](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/collaborating-on-repositories-with-code-quality-features/about-status-checks)和[关于受保护的分支](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches)。
+ **Bitbucket 存储库**：Bitbucket 的 [Using branch permissions](https://confluence.atlassian.com/bitbucketserver/using-branch-permissions-776639807.html) 和 [Take control with branch permissions in Bitbucket Cloud](https://bitbucket.org/blog/take-control-with-branch-restrictions) 文档。
+ **GitLab 存储库**： GitLab[自动合并](https://docs.gitlab.com/ee/user/project/merge_requests/auto_merge.html)和[受保护分支](https://docs.gitlab.com/ee/user/project/protected_branches.html)的文档。
# 将 Jira 事务与拉 CodeCatalyst 取请求相关联
您可以将 CodeCatalyst 源存储库中创建的拉取请求链接到 Jira 议题。链接 Jira 事务后，该事务将显示为拉取请求的属性。因此，拉取请求事件、工作流事件和部署事件将发送到 Jira 并添加到 Jira 事务中。拉取请求可以链接到一个或多个 Jira 事务。您只能链接 CodeCatalyst 源存储库中的拉取请求，不能链接第三方存储库中的拉取请求 GitHub。在将 Jira 事务与拉取请求关联之前，必须先将您的 Jira 项目链接到该 CodeCatalyst 项目。有关将 Jira 项目链接到项目的更多信息，请参阅[在中关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst](extensions-link.md)。 CodeCatalyst
**注意**
如果 CodeCatalyst 项目中没有包含两个分支的源存储库，则无法创建拉取请求。有关拉取请求的更多信息，请参阅[中的处理拉取请求 CodeCatalyst](source-pull-requests.md)。
**将 Jira 事务与拉 CodeCatalyst 取请求相关联**
1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。
1. 导航到您的 CodeCatalyst 项目。
1. 在导航窗格中，选择**代码**，然后选择**拉取请求**。
1. 选择**创建拉取请求**以输入拉取请求详细信息。
1. 从**源存储库**下拉菜单中，选择要在其中链接拉取请求的源存储库。
1. 从**源分支**下拉菜单中，选择包含要审查的更改的分支。
1. 从**目标分支**下拉菜单中，选择要在其中合并已审查的更改的分支。
1. 在**拉取请求标题**文本输入字段中，输入拉取请求的标题。
1. 为 **Jira 事务 - *可选***字段选择**链接事务**，选择下拉菜单，然后从链接的 Jira 项目中搜索要添加的 Jira 事务。
1. 选择要添加到拉取请求的 Jira 事务。
1. 选择**创建**以创建拉取请求。
将 Jira 事务与 CodeCatalyst 拉取请求关联后，即可获得拉取请求的摘要。摘要包括工作流运行、链接的事务、所需的审阅者、可选的审阅者和作者。
**注意**
与 Jira 事务相关的@@ **受让人和****创建**者信息在中不可用。 CodeCatalyst
关联拉取请求后，同步的 CodeCatalyst 项目和 Jira 项目允许来自 CodeCatalyst 的更新反映在你的 Jira 项目中。在 Jira 中查看已链接的拉取请求以及任何与该拉取请求相关的工作流事件的状态时，该状态将显示在 Jira 事务中。有关在 Jira 中查看 CodeCatalyst 事件的更多信息，请参阅[在 Jira 事务中查看 CodeCatalyst 事件](view-codecatalyst-events-jira.md)。
# 在 Jira 事务中查看 CodeCatalyst 事件
如果您的 CodeCatalyst 项目和 Jira 项目已关联，则拉取请求的摘要状态和关联 CodeCatalyst 的工作流事件的状态将反映在您的 Jira 事务中。例如，如果您关闭或合并拉取请求 CodeCatalyst，则状态更新将反映在 Jira 问题中。 CodeCatalyst 与 CodeCatalyst 拉取请求相关的工作流程 CI/CD 事件是同步的，因此成功运行的工作流程也会发送到 Jira 事务。
**查看 Jira 事务中的 CodeCatalyst 事件**
1. 打开 CodeCatalyst 控制台，[网址为 https://codecatalyst.aws/](https://codecatalyst.aws/)。
1. 导航到您的 CodeCatalyst 项目。
1. 在 CodeCatalyst 导航窗格中，选择 “**代码**”，选择 “**拉取请求**”，然后选择要在 Jira 项目中查看的 Jira 事务的拉取请求。
1. 在**其它信息**窗格中，选择要在 Jira 项目中查看的 Jira 事务。
1. 从 Jira 项目的**详细信息**窗格中，选择为**开发**列出的**拉取请求**以查看拉取请求的详细信息。
1. （可选）要查看最新构建，请选择**构建**选项卡。
1. （可选）要查看开发状态，请选择**部署**选项卡。