配置 Bitbucket

DevOps Insights 將於 2026 年 8 月 31 日結束服務並停止提供。Continuous Delivery 將於 2027 年 2 月 12 日在以下地區停止提供：au-syd、ca-mon、ca-tor、us-east。 Code Risk Analyzer 也將於該日於所有地區停止服務。 若某個區域未實際使用這些功能，該區域中的功能可能會提前停用，並停止接受新的實例。 了解更多

請將您的原始碼儲存於 bitbucket.org 上的新或現有儲存庫（repo）中，並透過維基、問題追蹤及拉取請求參與社群編碼。

配置 Bitbucket 以與團隊對程式碼進行分工合作：

  1. 從 IBM Cloud 控制台點擊選單圖示（漢堡圖示 ）> 平台自動化 > 工具鏈。 在「工具鏈」頁面上，按一下您要新增 Bitbucket 的工具鏈。

    a. 點擊「新增工具」。

    b. 在「工具整合」區段中，按一下 Bitbucket。

    如果您要在 IBM Cloud Public 上配置此工具整合，但未授權 IBM Cloud 存取 Bitbucket，請按一下授權來移至 Bitbucket 網站。 如果您沒有作用中的 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 網站，您可以在其中檢視儲存庫的內容。

  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 儲存庫的 ID。
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 Cloud 資源。