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

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

# 快速入门：安装扩展、连接提供商和链接资源 CodeCatalyst
<a name="extensions-quickstart"></a>

本教程演练了以下三个任务：

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 目录中安装第三方扩展
<a name="extensions-quickstart-install"></a>

在中使用第三方资源的第一步 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 空间
<a name="extensions-github-extension-get-started-connect"></a>

安装**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 项目
<a name="extensions-quickstart-link"></a>

使用您的 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)。

## 后续步骤
<a name="extensions-quickstart-next-steps"></a>

安装**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)。