链接源存储库 - Amazon CodeCatalyst

链接源存储库

将源存储库链接到项目时,如果您的空间安装了用于托管存储库的服务的 CodeCatalyst 扩展,则可以包含具有该扩展的存储库。只有具有空间管理员角色的用户才能安装扩展。一旦安装了扩展,就可以链接到为该扩展访问而配置的存储库。有关更多信息,请参阅在空间中安装扩展在 CodeCatalyst 中链接 GitHub 存储库、Bitbucket 存储库、GitLab 项目存储库和 Jira 项目

重要

安装存储库扩展后,您链接到 CodeCatalyst 的任何存储库的代码都将存储在 CodeCatalyst 中并建立索引。这样一来,便能在 CodeCatalyst 中搜索代码。要更好地了解在 CodeCatalyst 中使用已链接存储库时对代码实施的数据保护,请参阅《Amazon 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 中的拉取请求中可用。

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

重要

CodeCatalyst 不支持检测已链接存储库的默认分支中的更改。要更改已链接存储库的默认分支,您必须先取消该存储库与 CodeCatalyst 的链接,更改默认分支,然后重新链接该存储库。有关更多信息,请参阅 在 CodeCatalyst 中链接 GitHub 存储库、Bitbucket 存储库、GitLab 项目存储库和 Jira 项目

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

链接源存储库
  1. 导航到要链接存储库的项目。

    注意

    在链接存储库之前,具有空间管理员角色的用户必须首先为托管存储库的提供程序安装扩展。有关更多信息,请参阅 在空间中安装扩展

  2. 在导航窗格中,选择代码,然后选择源存储库

  3. 选择添加存储库,然后选择链接存储库

  4. 存储库提供程序下拉菜单中,选择以下第三方存储库提供程序之一:GitHubBitbucket

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

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

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

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

      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 中的另一个项目。

  6. 选择关联

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