本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
快速入门：安装扩展、连接提供商和链接资源 CodeCatalyst
本教程提供了以下三个任务的演练：
-
安装GitHub 存储库、Bitbucket 存储GitLab 库、存储库或 Jira Software 扩展程序。在外部站点中，系统会提示您连接并 CodeCatalyst 提供对第三方资源的访问权限，这将在下一步中完成。
重要
要将GitHub 存储库、Bitbucket GitLab 存储库、存储库或 Jira Softwar e 扩展程序安装到您的 CodeCatalyst 空间，您必须使用在该空间中具有空间管理员角色的账户登录。
-
将您的 GitHub 账户、Bitbucket 工作空间、 GitLab 用户或 Jira 网站连接到。 CodeCatalyst
重要
要将您的 GitHub 账户、Bitbucket 工作空间、 GitLab 用户或 Jira 站点连接到您的 CodeCatalyst 空间，您必须同时是第三方来源的管理员和 CodeCatalyst 空间管理员。
重要
安装存储库扩展后，您链接到的任何存储库都 CodeCatalyst 将对其代码进行索引和存储。 CodeCatalyst这将使代码可在中 CodeCatalyst搜索。要更好地了解在中使用链接存储库时代码的数据保护 CodeCatalyst，请参阅 Amazon CodeCatalyst 用户指南中的数据保护。
注意
如果您使用的是 GitHub 账户连接，则必须创建个人连接才能在您的身份和身份之间建立 CodeCatalyst 身份映射。 GitHub 有关更多信息，请参阅 人际关系 和 通过人际关系访问 GitHub 资源。
-
将您的 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库或 Jira 项目链接到您的 CodeCatalyst 项目。
重要
虽然您可以作为贡献者链接 GitHub 存储库、Bitbucket 存储库或 GitLab 项目仓库，但您只能以 Space 管理员或项目管理员的身份取消第三方仓库的链接。有关更多信息，请参阅 取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst。
要将您的 Jira 项目链接到您的 CodeCatalyst 项目，您必须是 CodeCatalyst Space 管理员或 CodeCatalyst 项目管理员。
重要
CodeCatalyst 不支持检测链接仓库的默认分支中的更改。要更改链接存储库的默认分支，必须先取消其与该分支的链接 CodeCatalyst，更改默认分支，然后再次进行链接。有关更多信息，请参阅 在中关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst。
作为最佳实践，在链接存储库之前，请务必确保您拥有最新版本的扩展程序。
注意
GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库只能链接到空间中的一个 CodeCatalyst 项目。
您不能将空仓库或已存档 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库与 CodeCatalyst 项目一起使用。
您不能链接与 GitLab 项目中 GitHub 仓库同名的存储库、Bitbucket 存储库或 CodeCatalyst 项目存储库。
GitHub 存储库扩展与 GitHub 企业服务器存储库不兼容。
Bitbucket 存储库扩展与 Bitbucket 数据中心存储库不兼容。
GitLab 存储库扩展与 GitLab 自行管理的项目存储库不兼容。
您不能在链接的仓库中使用 “为我写描述” 或 “汇总评论” 功能。这些功能仅在中的拉取请求中可用 CodeCatalyst。
一个 CodeCatalyst 项目只能链接到一个 Jira 项目。一个 Jira 项目可以链接到多个 CodeCatalyst 项目。
创建新 CodeCatalyst 项目时，您还可以安装GitHub 存储库、Bitbuck et GitLab 存储库、存储库扩展、连接到您的 GitHub 账户、Bitbucket 工作空间或 GitLab 用户，以及链接第三方存储库。有关更多信息，请参阅 使用链接的第三方存储库创建项目。
主题
步骤 1：从 CodeCatalyst 目录中安装第三方扩展
在中使用第三方资源的第一步 CodeCatalyst 是从目录中安装GitHub 存储库扩展。 CodeCatalyst 要安装扩展程序，请执行以下步骤，为要使用的第三方资源选择扩展程序。GitHub 存储库、Bitbucket 存储GitLab 库和存储库允许您在中使用 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库。 CodeCatalystJira Softwar e 允许您在中管理 Jira 问题。 CodeCatalyst
从 CodeCatalyst 目录中安装扩展
打开 CodeCatalyst 控制台，网址为 https://codecatalyst.aws/
。 导航到您的 CodeCatalyst 空间。
通过选择顶部菜单
中的目录图标来导航到目录。 CodeCatalyst CodeCatalyst 您可以搜索GitHub 存储库、Bitbucket 存储GitLab 库、存储库或 Jira So ftware。您也可以根据类别筛选附加信息。（可选）要查看有关扩展程序的更多详细信息，例如扩展程序将拥有的权限，请选择扩展名称。
选择安装。查看扩展所需的权限，如果要继续，请再次选择安装。
安装扩展程序后，您将进入扩展详细信息页面。根据您安装的扩展程序，您可以查看和管理连接的提供商和关联的资源。
第 2 步：将您的第三方提供商连接到您的 CodeCatalyst 空间
安装GitHub 存储库、Bitbucket 存储GitLab 库、存储库或 Jira Softwar e 扩展程序后，下一步是将您的 GitHub 账户、Bitbucket 工作空间、 GitLab 项目存储库或 Jira 站点连接到您的空间。 CodeCatalyst
将您的 GitHub 账户、Bitbucket 工作空间或 Jira 网站连接到 CodeCatalyst
-
根据您安装的第三方扩展程序，执行以下任一操作：
-
GitHub 存储库：Connect 连接到 GitHub 帐户。
-
在 “已连接的 GitHub 帐户” 选项卡中，选择 Connect GitHub 帐户以转到外部站点 GitHub。
-
使用您的 GitHub 凭证登录您的 GitHub 账户，然后选择要安装Amazon的账户 CodeCatalyst。
提示
如果您之前已将 GitHub 账户关联到该空间，则系统不会提示您重新授权。相反，如果您是多个组织的成员或合作者，则会看到一个对话框，询问您要在哪里安装扩展程序；如果您只属于一个 GitHub 组织，则会看到Amazon CodeCatalyst 应用程序的配置页面。 GitHub 为要允许的存储库访问权限配置应用程序，然后选择 Save。如果 “保存” 按钮未激活，请更改配置，然后重试。
-
选择是 CodeCatalyst 允许访问所有当前和将来的存储库，还是选择要在中使用的特定 GitHub 存储库 CodeCatalyst。默认选项是将 GitHub 账户中的所有 GitHub 存储库包括在内，包括将由访问的 future 存储库 CodeCatalyst。
-
查看授予的权限 CodeCatalyst，然后选择 “安装”。
将您的 GitHub 账户关联到后 CodeCatalyst，系统会将您带到GitHub 存储库扩展详情页面，您可以在其中查看和管理关联的 GitHub 账户和关联的 GitHub 存储库。
-
-
Bitbucket 存储库：连接到 Bitbucket 工作空间。
-
在 Conn ected Bitbucket 工作空间选项卡中，选择 Conn ect Bitbucket 工作空间以转到 Bitbucket 的外部
-
使用您的 Bitbucket 凭据登录您的 Bitbucket 工作空间并查看授予的权限。 CodeCatalyst
-
从 “授权工作空间” 下拉菜单中，选择要提供 CodeCatalyst 访问权限的 Bitbucket 工作空间，然后选择 “授予访问权限”。
提示
如果您之前已将 Bitbucket 工作空间连接到该空间，则系统不会提示您重新授权。相反，如果您是多个 Bitbucket 工作空间的成员或合作者，则会看到一个对话框，询问您要在哪里安装扩展程序；如果您只属于一个 Bitbucket 工作空间，则会看到亚马逊 CodeCatalyst 应用程序的配置页面。为要允许的工作空间访问权限配置应用程序，然后选择授予访问权限。如果 “授予访问权限” 按钮未激活，请更改配置，然后重试。
将 Bitbucket 工作空间连接到后 CodeCatalyst，您将被带到 Bitbucket 存储库扩展详细信息页面，您可以在其中查看和管理已连接的 Bitbucket 工作空间和关联的 Bitbucket 存储库。
-
-
GitLab 存储库：Connect 连接到 GitLab 用户。
-
选择 Connect GitLab 用户以访问外部站点 GitLab。
-
使用您的 GitLab 证书登录您的 GitLab 用户并查看授予的权限 CodeCatalyst。
提示
如果您之前已将 GitLab 用户连接到空间，则系统不会提示您重新授权。相反，您将被导航回 CodeCatalyst 控制台。
-
选择 “为 AWS 连接器授权” GitLab。
将 GitLab 用户连接到后 CodeCatalyst，系统会将您带到GitLab 存储库扩展详细信息页面，您可以在其中查看和管理关联的 GitLab 用户和关联的 GitLab 项目存储库。
-
-
Jira Software：连接 Jira 站点。
在 Conn ected Jira 站点选项卡中，选择 Connect Jira 站点以转到 Atlassian Marketplace 的外部站点。
选择 “立即获取”，开始在 Jira 网站上 CodeCatalyst 进行安装。
注意
如果您之前已安装 CodeCatalyst 到 Jira 站点，则会收到通知。选择 “开始使用” 进入最后一步。
根据您的角色，执行以下任一操作：
-
如果您是 Jira 站点管理员，请从站点下拉菜单中选择要安装应用程序的 Jira 站点，然后选择安装 CodeCatalyst 应用程序。
注意
如果您有一个 Jira 站点，则不会显示此步骤，系统会自动将您定向到下一步。
-
如果您不是 Jira 管理员，请从站点下拉菜单中选择要安装应用程序的 Jira 站点，然后选择请求 CodeCatalyst 应用程序。有关安装 Jira 应用程序的更多信息，请参阅谁可以安装应用程序？
。 在输入文本字段中输入需要安装 CodeCatalyst 的原因或保留默认文本，然后选择 S ubmit req uest。
-
查看安装应用程序 CodeCatalyst 时所执行的操作，然后选择 “立即获取”。
安装应用程序后，选择 “返回到” CodeCatalyst 以返回到 CodeCatalyst。
将 Jira 站点连接到后 CodeCatalyst，您可以在 Jira So f tware 扩展详细信息页面的 “已连接 Jira 站点” 选项卡中查看已连接的站点。
-
第 3 步：将您的第三方资源链接到您的 CodeCatalyst 项目
使用您的 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库或在中管理 Jira 事务的第三步也是最后一步 CodeCatalyst 是将它们链接到您要在其中使用它的 CodeCatalyst 项目。
从扩展详细信息页面将 GitHub 存储库、Bitbucket 存储库、项目存储库或 Jira CodeCatalyst 项目链接到项目 GitLab
-
根据您安装的第三方扩展程序和连接的提供商，执行以下任一操作：
-
GitHub 存储库：链接存储 GitHub 库。
在 “链接 GitHub 存储库” 选项卡中，选择 “链接 GitHub 存储库”。
从GitHub 账户下拉列表中，选择包含您要关联的存储库的 GitHub 账户。
从GitHub 存储库下拉列表中，选择要链接到 CodeCatalyst 项目的存储库。
提示
如果存储库的名称显示为灰色，则无法链接该存储库，因为它已经链接到空间中的另一个项目。
（可选）如果您在 GitHub 存储库列表中看不到存储库，则可能未在的 Amazon CodeCatalyst 应用程序中将其配置为可以访问存储库 GitHub。您可以配置可在关联账户 CodeCatalyst 中使用哪些 GitHub 存储库。
导航到您的GitHub
帐户，选择 “设置”，然后选择 “应用程序”。 在 “已安装的 GitHub 应用程序” 选项卡中，选择 Amazon CodeCatalyst 应用程序的 “配置”。
执行以下任一操作来配置要链接的 GitHub 存储库的访问权限 CodeCatalyst：
要提供对所有当前和未来存储库的访问权限，请选择 “所有存储库”。
要提供对特定存储库的访问权限，请选择 “仅选择存储库”，选择 “选择存储库” 下拉列表，然后选择要允许链接的存储库 CodeCatalyst。
从CodeCatalyst 项目下拉菜单中，选择要将 GitHub 存储库链接到的 CodeCatalyst 项目。
选择关联。
如果您不想再在中使用 GitHub 存储库 CodeCatalyst，可以取消它与 CodeCatalyst 项目的链接。解除存储库的链接后，该存储库中的事件将无法启动工作流程运行，并且您将无法在 CodeCatalyst 开发环境中使用该存储库。有关更多信息，请参阅 取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst。
-
比特存储库：链接 Bitbucket 存储库。
在关联的 Bitbucket 存储库选项卡中，选择链接 Bitbucket 存储库
从 Bitbucket 工作空间下拉列表中，选择包含要链接的存储库的 Bitbucket 工作空间。
从 Bitbucket 存储库下拉列表中，选择要链接到 CodeCatalyst 项目的存储库。
提示
如果存储库的名称显示为灰色，则无法链接该存储库，因为它已经链接到空间中的另一个项目。
从CodeCatalyst 项目下拉菜单中，选择要将 Bitbucket 存储库关联到的 CodeCatalyst 项目。
选择关联。
如果您不想再在中使用 Bitbucket 存储库 CodeCatalyst，可以取消该存储库与项目的链接。 CodeCatalyst 解除存储库的链接后，该存储库中的事件将无法启动工作流程运行，并且您将无法在 CodeCatalyst 开发环境中使用该存储库。有关更多信息，请参阅 取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst。
-
GitLab 存储库：链接 GitLab 项目存储库。
在 “链接的 GitLab 项目存储库” 选项卡中，选择 “链接 GitLab 项目存储库”。
从GitLab 用户下拉列表中，选择包含要链接的存储库的 GitLab 用户。
从GitLab 项目存储库下拉列表中，选择要链接到 CodeCatalyst 项目的存储库。
提示
如果存储库的名称显示为灰色，则无法链接该存储库，因为它已经链接到空间中的另一个项目。
从CodeCatalyst 项目下拉菜单中，选择要将 CodeCatalyst 项目存储库链接到的 GitLab 项目。
选择关联。
如果您不想再在中使用 GitLab 项目存储库 CodeCatalyst，则可以取消其与 CodeCatalyst 项目的链接。取消链接项目存储库后，该项目存储库中的事件将无法启动工作流程运行，并且您将无法在 CodeCatalyst 开发环境中使用该项目存储库。有关更多信息，请参阅 取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst。
-
Jira Software：链接 Jira 项目。
在 “链接的 Jira 项目” 选项卡中，选择 “链接 Jira 项目”。
从 Jira 站点下拉菜单中，选择包含您要关联的项目的 Jira 站点。
从 Jira 项目下拉菜单中，选择要链接到 CodeCatalyst 项目的项目。
从CodeCatalyst 项目下拉菜单中，选择要链接到 Jira 项目的项目。 CodeCatalyst
选择关联。
将 Jira 项目链接到 CodeCatalyst 项目后，将完全禁用对 CodeCatalyst 议题的访问权限， CodeCatalyst 导航窗格中的议题将被链接到 Jira 项目的 Jira 议题项所取代。
如果您不想再在中使用 Jira 项目 CodeCatalyst，可以取消其与项目的关联。 CodeCatalyst当 Jira 项目取消关联后，Jira 事务将不可用于该 CodeCatalyst项目，而 CodeCatalyst 问题将再次成为议题提供者。有关更多信息，请参阅 取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst。
-
您还可以在 C od e 中将您的 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库链接到源存储库中的项目。有关更多信息，请参阅 链接来自关联第三方提供商的资源。
后续步骤
安装GitHub 存储库、Bitbuck et GitLab 存储库或存储库扩展、连接资源提供商并将第三方存储库与 CodeCatalyst 项目关联后，您可以在 CodeCatalyst 工作流程和开发环境中使用它。您还可以在关联的 GitHub 账户、Bitbucket 工作区或 GitLab 使用蓝图生成的代码的用户中创建第三方存储库。有关更多信息，请参阅 在第三方存储库事件发生后自动启动工作流程 和 创建开发环境。
安装 Jira Software 扩展程序、连接您的 Jira 站点、将 Jira 项目链接到您的 CodeCatalyst 项目以及关联拉取请求后，来自的更新将反映在您 CodeCatalyst 的 Jira 项目中。有关将拉取请求与 Jira 议题关联的更多信息，请参阅将 Jira 事务与拉 CodeCatalyst 取请求相关联。有关在 Jira 中查看 CodeCatalyst 事件的更多信息，请参阅在 Jira 事务中查看 CodeCatalyst 事件。
