在 CodeCatalyst 中链接 GitHub 存储库、Bitbucket 存储库、GitLab 项目存储库和 Jira 项目 - Amazon CodeCatalyst
从已连接的第三方提供程序链接资源在项目创建期间链接第三方存储库

Amazon CodeCatalyst 不再向新客户开放。现有客户可以继续正常使用该服务。有关更多信息，请参阅 如何从 CodeCatalyst 迁移。

在 CodeCatalyst 中链接 GitHub 存储库、Bitbucket 存储库、GitLab 项目存储库和 Jira 项目

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

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

重要

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

重要

安装存储库扩展后，您链接到 CodeCatalyst 的任何存储库的代码都将存储在 CodeCatalyst 中并建立索引。这样一来，便能在 CodeCatalyst 中搜索代码。要更好地了解在 CodeCatalyst 中使用已链接存储库时对代码实施的数据保护，请参阅《Amazon CodeCatalyst 用户指南》中的数据保护。

重要

CodeCatalyst 不支持检测已链接存储库的默认分支中的更改。要更改已链接存储库的默认分支，您必须先取消该存储库与 CodeCatalyst 的链接，更改默认分支，然后重新链接该存储库。

作为最佳实践，在链接存储库之前，请始终确保您拥有最新版本的扩展。

您可以使用已链接 Jira 项目来管理事务，并将 CodeCatalyst 拉取请求链接到 Jira 事务。拉取请求的摘要状态和关联的 CodeCatalyst 工作流事件的状态将反映在您的 Jira 事务中。

重要

要将您的 Jira 项目链接到 CodeCatalyst 项目，您必须是 CodeCatalyst 空间管理员或 CodeCatalyst 项目管理员。

注意

  • GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库只能链接到空间中的一个 CodeCatalyst 项目。

  • 您无法在 CodeCatalyst 项目中使用空的或存档的 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库。

  • 您无法链接与 CodeCatalyst 项目中的存储库同名的 GitHub 存储库、Bitbucket 存储库或 GitLab 存储库。

  • GitHub 存储库扩展与 GitHub Enterprise Server 存储库不兼容。

  • Bitbucket 存储库扩展与 Bitbucket Data Center 存储库不兼容。

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

  • 您无法在已链接存储库中使用为我编写描述或汇总评论功能。这两项功能仅在 CodeCatalyst 中的拉取请求中可用。

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

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

  1. 通过访问 https://codecatalyst.aws/ 打开 CodeCatalyst 控制台。

  2. 导航到您的 CodeCatalyst 空间。

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

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

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

  4. 为下列扩展之一选择配置：GitHub 存储库、Bitbucket 存储库、GitLab 存储库或 Jira Software。

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

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

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

      2. 从 GitHub 账户下拉菜单中，选择包含要链接的存储库的 GitHub 账户。

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

        提示

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

      4. （可选）如果某个 GitHub 存储库未显示在存储库列表中，则可能未在 GitHub 中的 Amazon CodeCatalyst 应用程序中为其配置存储库访问权限。您可以在已连接账户中配置可在 CodeCatalyst 中使用的 GitHub 存储库。

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

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

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

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

          • 要提供对特定存储库的访问权限，请选择仅选择存储库，选择选择存储库下拉菜单，然后选择要允许在 CodeCatalyst 中链接的存储库。

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

      6. 选择链接。

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

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

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

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

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

        提示

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

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

      5. 选择链接。

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

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

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

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

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

        提示

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

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

      5. 选择链接。

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

    • Jira Software：链接 Jira 项目。

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

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

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

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

      5. 选择链接。

      在将 Jira 项目链接到 CodeCatalyst 项目后，将完全禁用对 CodeCatalyst 事务的访问权限，CodeCatalyst 导航窗格中的事务将替换为链接到 Jira 项目的 Jira 事务项。

      CodeCatalyst 事务将替换为导航窗格中已链接的 Jira 事务。

      如果您不再需要在 CodeCatalyst 中使用 Jira 项目，您可以取消它与 CodeCatalyst 项目的链接。在取消 Jira 项目链接时，Jira 事务将在 CodeCatalyst 项目中不可用，并且 CodeCatalyst 事务将再次成为事务提供方。有关更多信息，请参阅 在 CodeCatalyst 中取消链接 GitHub 存储库、Bitbucket 存储库、GitLab 项目存储库和 Jira 项目。

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

  1. 通过访问 https://codecatalyst.aws/ 打开 CodeCatalyst 控制台。

  2. 导航到您的 CodeCatalyst 项目。

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

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

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

  6. 根据您已选择链接的第三方存储库提供程序，执行下列操作之一：

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

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

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

        提示

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

      3. （可选）如果某个 GitHub 存储库未显示在存储库列表中，则可能未在 GitHub 中的 Amazon CodeCatalyst 应用程序中为其配置存储库访问权限。您可以在已连接账户中配置可在 CodeCatalyst 中使用的 GitHub 存储库。

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

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

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

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

          • 要提供对特定存储库的访问权限，请选择仅选择存储库，选择选择存储库下拉菜单，然后选择要允许在 CodeCatalyst 中链接的存储库。

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

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

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

        提示

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

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

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

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

        提示

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

  7. 选择链接。

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

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

将 Jira 项目链接到 CodeCatalyst 项目并链接拉取请求后，来自 CodeCatalyst 的更新将反映在 Jira 项目中。有关将拉取请求链接到 Jira 事务的更多信息，请参阅将 Jira 事务链接到 CodeCatalyst 拉取请求。有关查看 Jira 中的 CodeCatalyst 事件的更多信息，请参阅查看 Jira 事务中的 CodeCatalyst 事件。

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