配置 Git Repos and Issue Tracking

DevOps Insights 该服务将于 2026 年 8 月 31 日停止提供并终止。Continuous Delivery 将于 2027 年 2 月 12 日在以下区域停止提供：au-syd、ca-tor、us-east。 Code Risk Analyzer 也将于该日期在所有地区停止提供服务。 如果某个区域未实际使用这些功能，该区域内的相关功能可能会提前停用，并停止接受新实例。 了解更多

该 Git Repos and Issue Tracking 工具集成基于 GitLab Community Edition，这是一款面向 Git 仓库（repos）的基于 Web 的托管服务。 您可以同时具有存储库的本地和远程副本。 了解更多信息，请参见 Git Repos and Issue Tracking。

如果您在创建工具链时配置 Git Repos and Issue Tracking，请遵循以下步骤：

  1. 在“可配置的集成”部分中，单击 Git Repos and Issue Tracking。
  2. 复查 Git 存储库的缺省目标位置。 那些存储库是从样本存储库克隆而来的。 如果需要，请更改目标存储库的名称。

如果您有工具链，并且希望将工具链中的 Git 存储库迁移到 Git Repos and Issue Tracking，请执行以下步骤：

这些指示信息适用于已包含要迁移到 Git Repos and Issue Tracking 的 Git 存储库的工具链。 有关向工具链添加不同类型 Git 存储库的信息，请参阅 《配置》 GitHub 和 《配置 GitLab 》。

  1. 在控制 IBM Cloud 台中，点击菜单图标（汉堡图标 ）> 平台自动化 > 工具链。 在“工具链”页面上，单击某个工具链以打开其“概述”页面。
  2. 单击添加。
  3. 在“工具集成”部分中，单击 Git Repos and Issue Tracking。
  4. 选择要将代码更改部署到的服务器。 创建集成后，可以对其进行编辑以管理您有权使用的服务器列表。 单击 管理授权 以查看所有服务器的列表，并删除您提供的用于授权服务器的令牌。
  5. 要创建 Git 存储库的副本，对于存储库类型，请单击克隆。 输入新存储库名称和源存储库的 URL。
  6. 将自动选择您的用户名以将此新集成的所有权分配给您自己。 创建集成后，另一个授权用户可以在编辑集成时将其所有权重新分配给主题。
  7. 如果要创建专用存储库，请选中 使此存储库成为专用存储库 复选框。
  8. 如果要使用 Issues 进行问题跟踪，请选中启用 Issues 复选框。
  9. 如果要通过在提交上创建标记和注释以及在提交所引用的问题上创建标签和注释来跟踪代码更改的部署，请选中跟踪代码更改的部署复选框。
  10. 单击创建集成。

克隆 Git 存储库后，可以将其从工具链中除去。

如果您具有工具链且要向其添加 Git Repos and Issue Tracking，请遵循以下步骤：

  1. 在控制 IBM Cloud 台中，点击菜单图标（汉堡图标 ）> 平台自动化 > 工具链。 在“工具链”页面上，单击某个工具链以打开其“概述”页面。

  2. 单击 “添加工具”。

  3. 在“工具集成”部分中，单击 Git Repos and Issue Tracking。

  4. 选择要将代码更改部署到的服务器。 创建集成后，可以对其进行编辑以管理您有权使用的服务器列表。 单击 管理授权 以查看所有服务器的列表，并删除您提供的用于授权服务器的令牌。

  5. 选择存储库类型：

    a. 要创建空的存储库，对于存储库类型，请单击新建并输入存储库名称。 b. 要派生 Git 存储库以便您可以通过合并请求来提供更改，对于存储库类型，请单击派生。 输入源存储库的 URL。 c. 要创建 Git 存储库的副本，对于存储库类型，请单击克隆。 输入新存储库名称和源存储库的 URL。 d. 如果您有 GitHub 存储库并且要使用该存储库，那么对于存储库类型，请单击现有。 输入源存储库的 URL。

  6. 将自动选择您的用户名以将此新集成的所有权分配给您自己。 创建集成后，另一个授权用户可以在编辑集成时将其所有权重新分配给主题。

  7. 如果要创建专用存储库，请选中 使此存储库成为专用存储库 复选框。

  8. 如果要使用 Issues 进行问题跟踪，请选中启用 Issues 复选框。

  9. 如果要通过在提交上创建标记和注释以及在提交所引用的问题上创建标签和注释来跟踪代码更改的部署，请选中跟踪代码更改的部署复选框。

  10. 单击创建集成。

  11. 在工具链的“概述”页面的 存储库 卡上，单击要使用的 Git 存储库。 此时将打开项目概述页面。

如果您对要链接到的存储库没有支配者或所有者特权，那么您的集成将受到限制，因为您无法使用 Webhook。 将提交推送到存储库时，需要 Webhook 才能自动运行管道。 没有 Webhook，您必须手动启动管道。

使用 API 配置 Git Repos and Issue Tracking

Git Repos and Issue Tracking 工具集成支持以下配置参数，您可以在 创建、读取和 更新工具集成时使用工具 链 HTTP API 和 SDK。

必须在请求主体中使用 hostedgit 值指定 tool_type_id 属性。

Git Repos and Issue Tracking工具集成参数
参数 用途 类型 Terraform 自变量 描述
API根路径 可选，可更新 字符串 API根路径 Git Repos and Issue Tracking API 的 URL。
API令牌 可选，可更新 密码 API令牌 个人访问令牌（PAT）。 仅当 auth_type 设置为 pat 时，才需要此参数，否则将忽略此参数。
auth_type 可选，可更新，Default: oauth 字符串 auth_type 设置用于访问 Git 提供程序的认证方法。
缺省分支 可选，可更新 字符串 缺省分支 Git 存储库的缺省分支的名称。
enable_traceability 可选，可更新，Default: false 布尔值 enable_traceability 将此值设置为 true，即可通过在提交、拉取请求和相关问题上创建标签、标记和评论，来跟踪代码变更的部署情况。
Git ID 可选，不可更改 字符串 Git ID 将此值设置为 hostedgit 到目标 Git Repos and Issue Tracking。
has_issues 可选，可更新，Default: true 布尔值 已启用工具链问题 将此值设置为 true 以启用 Git Repos and Issue Tracking 存储库上的问题，并将“问题”工具集成卡添加到工具链。 将此值设置为 false 以从工具链中除去工具集成卡。 此操作不会影响是否在 Git Repos and Issue Tracking 存储库本身上启用了问题。
集成所有者 可选，可更新 字符串 集成所有者 选择执行 Git 操作的用户。
owner_id 可选，不可更改 字符串 owner_id 拥有存储库的 Git Repos and Issue Tracking 用户或组。 当您创建存储库或克隆或派生存储库时，此参数是必需的。 链接到现有存储库时，将计算此值。
私有仓库 可选，不可变，Default: true 布尔值 私有仓库 将此值设置为 true 以在创建存储库时，或者在克隆或派生存储库时使该存储库成为专用存储库。 链接到现有存储库时，不会使用此参数。
repo_id 可选，不可更改 字符串 repo_id Git Repos and Issue Tracking 项目的ID。
repo_name 可选，不可更改 字符串 repo_name 要创建的 Git Repos and Issue Tracking 仓库的名称。 当您创建存储库或克隆或派生存储库时，此参数是必需的。 当您链接到现有存储库时，将计算此值。
repo_url 可选，不可更改 字符串 repo_url 该工具集成的 URL Git Repos and Issue Tracking repo。 链接到现有存储库时，此参数是必需的。 此值在您创建存储库时计算，或者克隆或派生存储库时计算。
源代码仓库网址 可选，不可更改 字符串 源代码仓库网址 您要分叉或克隆的 repo 的 URL。 当您派生或克隆存储库时，此参数是必需的，但当您创建存储库或链接到现有存储库时，不会使用此参数。
令牌网址 可选，可更新 字符串 令牌网址 用于向 Git Repos and Issue Tracking 服务器授权的令牌 URL。
类型 必需，不可更改 字符串 类型 要执行的用于初始化新工具集成的操作。 使用 new 来创建 Git 存储库，clone 将现有 Git 存储库克隆到新的 Git 存储库中，fork 以派生现有 Git 存储库，或者 link 以链接到现有 Git 存储库。

若您 IBM Cloud 使用受信任配置檔登入，在設定工具 Git Repos and Issue Tracking 整合時，必須採用個人存取權杖驗證方式。 OAuth 身份验证方法与可信 Profiles.The 个人访问令牌 (PAT) 身份验证不兼容，您可以使用图形用户界面、API 或 Terraform 配置 Git Repos and Issue Tracking 工具的集成。 这是因为 PAT 与拥有受信任配置文件的实际用户绑定。 用户可以使用个人访问令牌在工具链中创建或重新配置 Git Repos and Issue Tracking 工具集成。 不过，他们应该以普通用户身份登录，以访问 Git repo 的实际用户界面。