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

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

# 在中关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst
<a name="extensions-link"></a>

在使用 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)

## 从已连接的第三方提供程序链接资源
<a name="extensions-link-resources"></a>

**从扩展详细信息页面将 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 项目创建过程中将第三方存储库链接到
<a name="extensions-link-repositories-creation"></a>

在创建新项目时，您可以将存储 GitHub 库、Bitbucket 存储库或 GitLab 项目存储库链接到新 CodeCatalyst 项目。 CodeCatalyst 有关更多信息，请参阅 [使用链接的第三方存储库创建项目](projects-create.md#projects-create-3p-repo)。