View a markdown version of this page

快速入门:在中安装扩展、连接提供商和链接资源 CodeCatalyst - 亚马逊 CodeCatalyst

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

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

快速入门:在中安装扩展、连接提供商和链接资源 CodeCatalyst

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

  1. 安装GitHub 存储库 Bitbucket 存储GitLab 库、存储库或 Jira Software 扩展程序。外部站点会提示你连接并 CodeCatalyst 提供对第三方资源的访问权限,这是下一步的一部分。

    重要

    要将GitHub 存储库 Bitbucket 存储GitLab 库、存储库或 Jira Software 扩展程序安装到您的 CodeCatalyst 空间,您必须使用在空间中具有 Space 管理员角色的账户登录。

  2. 将您的 GitHub 账户、Bitbucket 工作空间、 GitLab 用户或 Jira 网站连接到。 CodeCatalyst

    重要

    要将您的 GitHub 账户、Bitbucket 工作空间、 GitLab 用户或 Jira 网站连接到您的 CodeCatalyst 空间,您必须既是第三方来源的管理员又是 CodeCatalyst 空间管理员。

    重要

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

    注意

    如果您使用与 GitHub 账户的连接,则必须创建个人连接以在您的身份和身份之间建立 CodeCatalyst 身份映射。 GitHub 有关更多信息,请参阅个人连接通过个人关系访问 GitHub 资源

  3. 将您的 GitHub 存储库、Bitbucket 存储库、 GitLab 项目存储库或 Jira 项目链接到您的 CodeCatalyst 项目。

    重要
    重要

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

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

    注意
    • 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 项目。

您还可以安装GitHub 存储库 Bitbucket 存储GitLab 库、存储库扩展,连接到您的 GitHub 账户、Bitbucket 工作空间或 GitLab 用户,以及在创建新 CodeCatalyst 项目时关联第三方存储库。有关更多信息,请参阅 使用链接的第三方存储库创建项目

第 1 步:安装 CodeCatalyst 目录中的第三方扩展

在中使用第三方资源的第一步 CodeCatalyst 是安装目录中的GitHub 存储库扩展。 CodeCatalyst 要安装该扩展,请执行以下步骤,为要使用的第三方资源选择扩展。GitHub 存储库 Bitbucket 存储GitLab 库和存储库允许您在中使用 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库。 CodeCatalystJira Software 允许您在中管理 Jira 事务。 CodeCatalyst

安装 CodeCatalyst 目录中的扩展
  1. 在处打开 CodeCatalyst 控制台https://codecatalyst.aws/

  2. 导航到您的 CodeCatalyst 空间。

  3. 通过选择顶部菜单 The CodeCatalyst catalog icon in the top navigation bar in CodeCatalyst. 中的目录图标来导航到目录。 CodeCatalyst CodeCatalyst 你可以搜索GitHub 存储库 Bitbucket 存储GitLab 库、存储库或 Jira Software。您也可以根据类别筛选扩展。

  4. (可选)要查看有关扩展的更多详细信息(例如扩展将具有的权限),请选择扩展名。

  5. 选择安装。查看扩展所需的权限,如果要继续,请再次选择安装

安装扩展后,您将进入扩展详细信息页面。根据已安装的扩展,您可以查看和管理连接的提供程序和链接的资源。

第 2 步:将您的第三方提供商连接到您的 CodeCatalyst 空间

安装GitHub 存储库 Bitbucket 存储GitLab 库、存储库或 Jira Software 扩展程序后,下一步是将您的 GitHub 账户、Bitbucket 工作空间、 GitLab 项目存储库或 Jira 站点连接到您的空间。 CodeCatalyst

将您的 GitHub 账户、Bitbucket 工作空间或 Jira 网站连接到 CodeCatalyst
  • 根据已安装的第三方扩展,执行下列操作之一:

    • GitHub 存储库:连接到 GitHub 账户。

      1. 在 “关联 GitHub 帐户” 选项卡中,选择 “连接 GitHub 帐户” 以访问外部站点 GitHub。

      2. 使用您的 GitHub 证书登录您的 GitHub 账户,然后选择要安装亚马逊的账户 CodeCatalyst。

        提示

        如果您之前已将 GitHub 账户关联到该空间,则系统不会提示您重新授权。相反,如果您是多个组织的成员或合作者,则会看到一个对话框询问您要在哪里安装扩展程序;如果您只属于一个 GitHub 组织,则会看到亚马逊 CodeCatalyst 应用程序的配置页面。 GitHub 为要允许的存储库访问权限配置应用程序,然后选择保存。如果保存按钮未激活,请更改配置,然后重试。

      3. 选择是 CodeCatalyst 要允许访问所有当前和未来的存储库,还是选择要在其中使用的特定 GitHub 存储库 CodeCatalyst。默认选项是将所有 GitHub 存储库包含在 GitHub 账户中,包括未来将由访问的存储库 CodeCatalyst。

      4. 查看授予的权限 CodeCatalyst,然后选择 “安装”

      将您的 GitHub 账户关联到后 CodeCatalyst,您将进入GitHub 存储库扩展详情页面,您可以在其中查看和管理关联的 GitHub 账户和关联的 GitHub 仓库。

    • Bitbucket 存储库:连接到 Bitbucket 工作区。

      1. 已连接的 Bitbucket 工作区选项卡中,选择连接 Bitbucket 工作区以转到 Bitbucket 的外部站点。

      2. 使用您的 Bitbucket 凭据登录您的 Bitbucket 工作空间并查看授予的权限。 CodeCatalyst

      3. 从 “为工作空间授权” 下拉菜单中,选择要提供 CodeCatalyst 访问权限的 Bitbucket 工作空间,然后选择授予访问权限

        提示

        如果您之前已将 Bitbucket 工作区连接到空间,则系统不会提示您重新授权。如果您是多个 Bitbucket 工作空间的成员或合作者,您将看到一个对话框,询问您想在哪里安装扩展程序;如果您只属于一个 Bitbucket 工作空间,则会看到亚马逊 CodeCatalyst 应用程序的配置页面。为要允许的工作区访问权限配置应用程序,然后选择授予访问权限。如果授予访问权限按钮未激活,请更改配置,然后重试。

      将您的 Bitbucket 工作空间连接到后 CodeCatalyst,您将进入 Bitbucket 存储库扩展详情页面,您可以在其中查看和管理连接的 Bitbucket 工作空间和关联的 Bitbucket 存储库。

    • GitLab 存储库:连接到 GitLab 用户。

      1. 选择 “连接 GitLab 用户” 以访问外部站点 GitLab。

      2. 使用您的 GitLab 证书登录您的 GitLab 用户并查看授予的权限 CodeCatalyst。

        提示

        如果您之前已将 GitLab 用户连接到该空间,则系统不会提示您重新授权。相反,您将被导航回 CodeCatalyst 控制台。

      3. 选择 “为 AWS 连接器授权” GitLab

      将 GitLab 用户连接到后 CodeCatalyst,您将进入GitLab 存储库扩展详细信息页面,您可以在其中查看和管理关联的 GitLab 用户和链接的 GitLab 项目存储库。

    • Jira Software:连接 Jira 站点。

      1. 已连接的 Jira 站点选项卡中,选择连接 Jira 站点以转到 Atlassian Marketplace 的外部站点。

      2. 选择 “立即获取” 以开始 CodeCatalyst 在您的 Jira 网站上进行安装。

        注意

        如果您之前已安装 CodeCatalyst 到 Jira 站点,则会收到通知。选择开始使用以入最后一步。

      3. 根据您的角色,请执行下列操作之一:

        1. 如果您是 Jira 站点管理员,请从站点下拉菜单中选择要安装应用程序的 Jira 站点,然后选择安装 CodeCatalyst 应用程序。

          注意

          如果您有一个 Jira 站点,则不会显示此步骤,系统会自动将您转到下一步。

          1. 如果您不是 Jira 管理员,请从站点下拉菜单中选择要安装应用程序的 Jira 站点,然后选择请求 CodeCatalyst 应用程序。有关安装 Jira 应用程序的更多信息,请参阅 Who can install apps?

          2. 在输入文本字段中 CodeCatalyst 输入需要安装的原因或保留默认文本,然后选择提交请求

      4. 查看安装应用程序 CodeCatalyst 时执行的操作,然后选择 “立即获取”

      5. 安装应用程序后,选择 “返回” CodeCatalyst 以返回 CodeCatalyst。

      将您的 Jira 站点连接到后 CodeCatalyst,您可以在 Jira Software 扩展程序详细信息页面的互联的 Jira 站点选项卡中查看连接的站点。

使用您的 GitHub 仓库、Bitbucket 存储库或 GitLab 项目存储库或在中管理 Jira 事务的第三步,也是最后一步 CodeCatalyst 是将它们链接到您要在其中使用它的 CodeCatalyst 项目。

从扩展详细信息页面将 GitHub 存储库、 GitLab Bitbucket 存储库、项目存储库或 Jira CodeCatalyst 项目链接到项目
  • 根据已安装的第三方扩展和已连接的提供程序,执行下列操作之一:

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

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

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

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

        提示

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

      4. (可选)如果您未在 GitHub 存储库列表中看到存储库,则可能未在中的亚马逊 CodeCatalyst 应用程序中将其配置为允许访问存储库 GitHub。您可以配置可在关联账户 CodeCatalyst 中使用哪些 GitHub 存储库。

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

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

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

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

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

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

      6. 选择链接

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

    • Bitbucket 存储库:链接 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 问题项目所取代。

      CodeCatalyst 导航窗格中的问题已替换为链接的 Jira 问题。

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

您还可以将您的 GitHub 存储库、Bitbucket 存储库或 GitLab 项目存储库从 Code 中的源存储库链接到项目。有关更多信息,请参阅 从已连接的第三方提供程序链接资源

后续步骤

安装GitHub 存储库 Bitbucket GitLab 存储库或存储库扩展,连接资源提供商并将第三方存储库链接到 CodeCatalyst 项目后,您可以在 CodeCatalyst 工作流程和开发环境中使用它。您还可以使用蓝图生成的代码在关联 GitHub 账户、Bitbucket 工作空间或 GitLab 用户中创建第三方存储库。有关更多信息,请参阅在第三方存储库事件发生后自动启动工作流运行创建开发环境

安装 Jira Software 扩展程序、连接 Jira 站点、将 Jira 项目链接到 CodeCatalyst 项目以及关联拉取请求后,来自的更新将反映在您 CodeCatalyst 的 Jira 项目中。有关将拉取请求链接到 Jira 事务的更多信息,请参阅将 Jira 问题与拉 CodeCatalyst 取请求相关联。有关在 Jira 中查看 CodeCatalyst 事件的更多信息,请参阅在 Jira 议题中查看 CodeCatalyst 事件