配置 Bitbucket

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

将您的源代码存储在 bitbucket.org 上的新仓库或现有仓库中，并通过维基、问题跟踪和拉取请求参与社交编程。

配置 Bitbucket 以与团队协作编写代码：

  1. 在控制 IBM Cloud 台中，点击菜单图标（汉堡图标 ）> 平台自动化 > 工具链。 在“工具链”页面上，单击要向其添加 Bitbucket 的工具链。

    a. 单击 “添加工具”。

    b. 在“工具集成”部分中，单击 Bitbucket。

    如果要在 IBM Cloud Public 上配置此工具集成，但尚未授权 IBM Cloud 访问 Bitbucket，请单击授权以转至 Bitbucket Web 站点。 如果您没有活动的 Bitbucket 会话，那么系统会提示您登录。 单击授予访问权以允许 IBM Cloud 工具链访问 Bitbucket 帐户的以下部分：

    • 读取帐户信息。 获取基本用户信息以填充用户界面。

    • 读取和修改存储库的问题。 允许 Continuous Delivery 更新问题以指示管道何时部署连接到这些问题的提交。

    • 读取团队项目设置和读取团队项目中包含的存储库。 允许 Continuous Delivery 与团队拥有的存储库相集成。

    • 读取和修改存储库及其拉取请求。 允许 Continuous Delivery 在用户请求代码时将样本代码推送到存储库。

    • 管理存储库。 允许 Continuous Delivery 在用户请求时创建新存储库。

    • 读取团队成员资格信息。 允许 Continuous Delivery 在创建新存储库时显示的所有者菜单中显示团队列表。

    • 读取和修改存储库的 Webhook。 允许管道在将提交推送到存储库时触发构建。

    如果您有活动的 Bitbucket 会话，但最近未输入过密码，那么系统可能会提示您输入 Bitbucket 密码以进行确认。

  2. 单击要使用的 Bitbucket 服务器。

  3. 如果您有要使用的 Bitbucket 存储库，请输入该存储库的 URL。 对于存储库类型，请单击现有。

  4. 如果您想要使用新的 Bitbucket 存储库，请输入存储库的名称，输入您要克隆或派生的存储库的 URL，然后选择存储库类型：

    a. 要创建空的存储库，请单击新建。

    b. 要创建存储库的副本，请单击克隆。

    c. 要派生存储库以便您可以通过拉出请求来提供更改，请单击派生。

  5. 要在服务器上创建专用存储库，请选中使此存储库成为专用复选框。

  6. 要使用 Bitbucket Issues 进行问题跟踪，请选中启用 Bitbucket Issues 复选框。

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

  8. 单击创建集成。

  9. 在工具链中的 第三方工具 卡上，单击要使用的 Bitbucket 存储库的 Bitbucket 工具集成。 这将打开 Bitbucket Web 站点，您可在其中查看存储库的内容。

  10. 如果您已启用 Bitbucket Issues，请单击 Bitbucket Issues，以将其打开。 您可以对整个工具链使用此 Bitbucket Issues 实例，即使工具链包含多个 Bitbucket 存储库也不例外。

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

使用 API 配置 Bitbucket

Bitbucket 工具集成支持以下配置参数，您可在 创建、读取和 更新工具集成时 通过工具链 HTTP API 和 SDK 使用这些参数。

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

Bitbucket 工具集成参数
参数 用途 类型 Terraform 自变量 描述
API根路径 可选，可更新 字符串 API根路径 Bitbucket API 的 URL，例如 https://api.bitbucket.org。
缺省分支 可选，可更新 字符串 缺省分支 缺省分支的名称，例如 main。
enable_traceability 可选的，可更新的，Default: false 布尔值 enable_traceability 将此值设置为 true，即可通过在提交、拉取请求和相关问题上创建标签、标记和评论，来跟踪代码变更的部署情况。
Git ID 可选，不可更改 字符串 Git ID 对于 bitbucket.org，请将此值设置为 bitbucketgit，或者设置为定制 Bitbucket 服务器的 GUID。
has_issues 可选的，可更新的，Default: true 布尔值 工具链问题启用 将此值设置为 true 以启用 Bitbucket 存储库上的问题，并将“问题”工具卡添加到工具链。 将此值设置为 false 以从工具链中除去工具集成卡。 此设置不会影响是否对 Bitbucket 存储库本身启用了“问题”。
集成所有者 可选，可更新 字符串 集成所有者 执行 Git 操作的用户。
owner_id 可选，不可更改 字符串 owner_id 拥有存储库的 Bitbucket 用户或组。 当您创建存储库或克隆或派生存储库时，此参数是必需的。 链接到现有存储库时，将计算此值。
私有仓库 可选的，不可变的，Default: false 布尔值 私有仓库 将此值设置为 true 以在创建存储库时，或者在克隆或派生存储库时使该存储库成为专用存储库。 链接到现有存储库时，不会使用此参数。
repo_id 可选，不可更改 字符串 repo_id Bitbucket 存储库的标识。
repo_name 可选，不可更改 字符串 repo_name 要创建的 Bitbucket 仓库的名称。 当您创建存储库或克隆或派生存储库时，此参数是必需的。 链接到现有存储库时，将计算此值。
repo_url 可选，不可更改 字符串 repo_url 此工具集成的Bitbucket存储库的 URL。 链接到现有存储库时，此参数是必需的。 此值在您创建存储库时计算，或者克隆或派生存储库时计算。
源代码仓库网址 可选，不可更改 字符串 源代码仓库网址 您想要分叉或克隆的仓库的 URL 地址。 当您派生或克隆存储库时，此参数是必需的，但当您创建存储库或链接到现有存储库时，不会使用此参数。
令牌网址 可选，可更新 字符串 令牌网址 用于向 Bitbucket 服务器进行授权的 URL 令牌。
类型 必需，不可更改 字符串 类型 要执行的用于初始化新工具集成的操作。 使用 new 创建 Git 存储库，使用 clone 将现有存储库克隆到新的 Git 存储库中，使用 fork 派生现有 Git 存储库，或者使用 link 链接到现有 Git 存储库。

了解有关 Bitbucket 的更多信息

要了解有关 Bitbucket 的更多信息，请参阅 Bitbucket 云资源。