在中关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst - Amazon CodeCatalyst
链接来自关联第三方提供商的资源在项目创建过程中链接第三方存储库

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

在中关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst

在使用 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库或管理 Jira 项目之前，必须将存储库或项目所属的第三方源与您的 CodeCatalyst 空间连接起来。有关更多信息，请参阅 关联 GitHub 账户、Bitbucket 工作空间、 GitLab 用户和 Jira 站点 CodeCatalyst。

您可以在工作流程中使用链接 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库，其中链接存储库中的事件会启动可能构建、测试或部署代码的工作流程，具体取决于工作流程配置。使用链接存储库 GitHub 或 Bitbucket 存储库的工作流程配置文件存储在链接存储库中。链接存储库还可以与开发环境一起使用，以创建、更新和删除链接存储库中的文件。您可以从 GitHub 存储库、Bitbucket 存储库或 GitLab 存储库扩展的详细信息页面，或者从 CodeCatalyst 项目本身的 “代码” 中的 “源存储库” 视图将GitLab 存储库、Bitbuck et 存储库或项目存储库链接到项目。GitHub

重要

虽然您可以以贡献者的身份链接 GitHub 或 Bitbucket 存储库，但您只能以 Space 管理员或项目管理员的身份取消第三方仓库的链接。有关更多信息，请参阅 取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst。

重要

安装存储库扩展后，您链接到的任何存储库都 CodeCatalyst 将对其代码进行索引和存储。 CodeCatalyst这将使代码可在中 CodeCatalyst搜索。要更好地了解在中使用链接存储库时代码的数据保护 CodeCatalyst，请参阅 Amazon CodeCatalyst 用户指南中的数据保护。

重要

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 数据中心存储库不兼容。

  • GitLab 存储库扩展与 GitLab 自行管理的项目存储库不兼容。

  • 您不能在链接的仓库中使用 “为我写描述” 或 “汇总评论” 功能。这些功能仅在中的拉取请求中可用 CodeCatalyst。

  • 一个 CodeCatalyst 项目只能链接到一个 Jira 项目。一个 Jira 项目可以链接到多个 CodeCatalyst 项目。

从扩展详细信息页面将 GitHub 存储库、Bitbucket 存储库、项目存储库或 Jira CodeCatalyst 项目链接到项目 GitLab

  1. 打开 CodeCatalyst 控制台，网址为 https://codecatalyst.aws/。

  2. 导航到您的 CodeCatalyst 空间。

  3. 执行以下任一操作，查看空间空间中已安装的扩展列表：

    1. 选择 “设置”，然后选择 “已安装的扩展”。

    2. 在顶部菜单 The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst. 中选择 “目录” 图标。

  4. 为以下扩展程序之一选择 “配置”：GitHub 存储库、Bitbucket 存储GitLab 库、存储库或 Jira So ftware。

  5. 根据您选择配置的第三方扩展，执行以下任一操作：

    • GitHub 存储库：链接存储 GitHub 库。

      1. 在 “链接 GitHub 存储库” 选项卡中，选择 “链接 GitHub 存储库”。

      2. 从GitHub 账户下拉列表中，选择包含您要关联的存储库的 GitHub 账户。

      3. 从GitHub 存储库下拉列表中，选择要链接到 CodeCatalyst 项目的存储库。

        提示

        如果存储库的名称显示为灰色，则无法链接该存储库，因为它已经链接到空间中的另一个项目。

      4. （可选）如果您在 GitHub 存储库列表中看不到存储库，则可能未在的 Amazon CodeCatalyst 应用程序中将其配置为可以访问存储库 GitHub。您可以配置可在关联账户 CodeCatalyst 中使用哪些 GitHub 存储库。

        1. 导航到您的GitHub帐户，选择 “设置”，然后选择 “应用程序”。

        2. 在 “已安装的 GitHub 应用程序” 选项卡中，为 Amazon CodeCatalyst 应用程序选择 “配置”。

        3. 执行以下任一操作来配置要链接的 GitHub 存储库的访问权限 CodeCatalyst：

          • 要提供对所有当前和未来存储库的访问权限，请选择 “所有存储库”。

          • 要提供对特定存储库的访问权限，请选择 “仅选择存储库”，选择 “选择存储库” 下拉列表，然后选择要允许链接的存储库 CodeCatalyst。

      5. 从CodeCatalyst 项目下拉菜单中，选择要将 GitHub 存储库链接到的 CodeCatalyst 项目。

      6. 选择关联。

      如果您不想再在中使用 GitHub 存储库 CodeCatalyst，可以取消它与 CodeCatalyst 项目的链接。解除存储库的链接后，该存储库中的事件将无法启动工作流程运行，并且您将无法在 CodeCatalyst 开发环境中使用该存储库。有关更多信息，请参阅 取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst。

    • 比特存储库：链接 Bitbucket 存储库。

      1. 在关联的 Bitbucket 存储库选项卡中，选择链接 Bitbucket 存储库

      2. 从 Bitbucket 工作空间下拉列表中，选择包含要链接的存储库的 Bitbucket 工作空间。

      3. 从 Bitbucket 存储库下拉列表中，选择要链接到 CodeCatalyst 项目的存储库。

        提示

        如果存储库的名称显示为灰色，则无法链接该存储库，因为它已经链接到空间中的另一个项目。

      4. 从CodeCatalyst 项目下拉菜单中，选择要将 Bitbucket 存储库关联到的 CodeCatalyst 项目。

      5. 选择关联。

      如果您不想再在中使用 Bitbucket 存储库 CodeCatalyst，可以取消该存储库与项目的链接。 CodeCatalyst 解除存储库的链接后，该存储库中的事件将无法启动工作流程运行，并且您将无法在 CodeCatalyst 开发环境中使用该存储库。有关更多信息，请参阅 取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst。

    • GitLab 存储库：链接 GitLab 项目存储库。

      1. 在 “链接的 GitLab 项目存储库” 选项卡中，选择 “链接 GitLab 项目存储库”。

      2. 从GitLab 用户下拉列表中，选择包含要链接的项目存储库的 GitLab 用户。

      3. 从GitLab 项目存储库下拉列表中，选择要链接到 CodeCatalyst 项目的存储库。

        提示

        如果存储库的名称显示为灰色，则无法链接该存储库，因为它已经链接到空间中的另一个项目。

      4. 从CodeCatalyst 项目下拉菜单中，选择要将 CodeCatalyst 项目存储库链接到的 GitLab 项目。

      5. 选择关联。

      如果您不想再在中使用 GitLab 项目存储库 CodeCatalyst，则可以取消其与 CodeCatalyst 项目的链接。取消链接项目存储库后，该项目存储库中的事件将无法启动工作流程运行，并且您将无法在 CodeCatalyst 开发环境中使用该项目存储库。有关更多信息，请参阅 取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst。

    • Jira Software：链接 Jira 项目。

      1. 在 “链接的 Jira 项目” 选项卡中，选择 “链接 Jira 项目”。

      2. 从 Jira 站点下拉菜单中，选择包含您要关联的项目的 Jira 站点。

      3. 从 Jira 项目下拉菜单中，选择要链接到 CodeCatalyst 项目的项目。

      4. 从CodeCatalyst 项目下拉菜单中，选择要链接到 Jira 项目的项目。 CodeCatalyst

      5. 选择关联。

      将 Jira 项目链接到 CodeCatalyst 项目后，将完全禁用对 CodeCatalyst 议题的访问权限， CodeCatalyst 导航窗格中的议题将被链接到 Jira 项目的 Jira 议题项所取代。

      如果您不想再在中使用 Jira 项目 CodeCatalyst，可以取消其与项目的关联。 CodeCatalyst当 Jira 项目取消关联后，Jira 事务将不可用于该 CodeCatalyst项目，而 CodeCatalyst 问题将再次成为议题提供者。有关更多信息，请参阅 取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst。

从项目的源 GitHub 存储库页面将存储库、Bitbucket 存储库或 GitLab CodeCatalyst 项目存储库链接到项目

  1. 打开 CodeCatalyst 控制台，网址为 https://codecatalyst.aws/。

  2. 导航到您的 CodeCatalyst 项目。

  3. 在导航窗格中，选择代码，然后选择源存储库。

  4. 选择 “添加存储库”，然后选择 “链接存储库”。

  5. 从存储库提供商下拉菜单中，选择以下第三方存储库提供商之一：GitHub、Bitbucket、GitLab。

  6. 根据您选择链接的第三方存储库提供商，执行以下任一操作：

    • GitHub 存储库：链接存储 GitHub 库。

      1. 从GitHub 账户下拉菜单中，选择包含您要关联的存储库的 GitHub 账户。

      2. 从GitHub 存储库下拉菜单中，选择要链接 CodeCatalyst 项目的 GitHub 存储库。

        提示

        如果存储库的名称显示为灰色，则无法链接该存储库，因为它已经链接到 Amazon CodeCatalyst 中的另一个项目。

      3. （可选）如果您在 GitHub 存储库列表中看不到存储库，则可能未在的 Amazon CodeCatalyst 应用程序中将其配置为可以访问存储库 GitHub。您可以配置可在关联账户 CodeCatalyst 中使用哪些 GitHub 存储库。

        1. 导航到您的GitHub帐户，选择 “设置”，然后选择 “应用程序”。

        2. 在 “已安装的 GitHub 应用程序” 选项卡中，为 Amazon CodeCatalyst 应用程序选择 “配置”。

        3. 执行以下任一操作来配置要链接的 GitHub 存储库的访问权限 CodeCatalyst：

          • 要提供对所有当前和未来存储库的访问权限，请选择 “所有存储库”。

          • 要提供对特定存储库的访问权限，请选择 “仅选择存储库”，选择 “选择存储库” 下拉列表，然后选择要允许链接的存储库 CodeCatalyst。

    • 比特存储库：链接 Bitbucket 存储库。

      1. 从 Bitbucket 工作空间下拉菜单中，选择包含要链接的存储库的 Bitbucket 工作空间。

      2. 从 Bitbucket 存储库下拉菜单中，选择要关联项目的 Bitbucket 存储库。 CodeCatalyst

        提示

        如果存储库的名称显示为灰色，则无法链接该存储库，因为它已经链接到 Amazon CodeCatalyst 中的另一个项目。

    • GitLab 存储库：链接 GitLab 项目存储库。

      1. 从GitLab 用户下拉菜单中，选择包含要链接的项目存储库的 GitLab 用户。

      2. 从GitLab 项目存储库下拉菜单中，选择要链接 CodeCatalyst 项目的项目存储库。 GitLab

        提示

        如果项目存储库的名称显示为灰色，则无法链接该项目存储库，因为它已经链接到 Amazon CodeCatalyst 中的另一个项目。

  7. 选择关联。

如果您不想再在中使用 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库 CodeCatalyst，则可以取消其与项目的链接。 CodeCatalyst 解除存储库的链接后，该存储库中的事件将无法启动工作流程运行，并且您将无法在 CodeCatalyst 开发环境中使用该存储库。有关更多信息，请参阅 取消关联 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库和 Jira 项目 CodeCatalyst。

将您的 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库链接到您的 CodeCatalyst 项目后，您可以在 CodeCatalyst 工作流程和开发环境中使用它。您还可以将链接存储库与 Amazon Q Developer、蓝图等配合使用。有关更多信息，请参阅 在第三方存储库事件发生后自动启动工作流程 和 创建开发环境。

将 Jira 项目与项目关联并关联拉取请求后，来自的更新将反映在您 CodeCatalyst 的 Jira CodeCatalyst 项目中。有关将拉取请求与 Jira 议题关联的更多信息，请参阅将 Jira 事务与拉 CodeCatalyst 取请求相关联。有关在 Jira 中查看 CodeCatalyst 事件的更多信息，请参阅在 Jira 事务中查看 CodeCatalyst 事件。

在创建新项目时，您可以将存储 GitHub 库、Bitbucket 存储库或 GitLab 项目存储库链接到新 CodeCatalyst 项目。 CodeCatalyst 有关更多信息，请参阅 使用链接的第三方存储库创建项目。