IBM Cloud Docs
配置 Bitbucket

配置 Bitbucket

將您的原始程式碼儲存在bitbucket.org上的新的或現有的儲存庫 (repo) 中,並透過 wiki、問題追蹤和拉取請求參與社交編碼。

配置 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 工具整合支援下列配置參數,可與 Toolchain HTTP API 及 SDK 搭配使用。

您必須在要求內文中以 bitbucketgit 值指定 tool_type_id 內容。

Bitbucket工具整合參數
參數 用法 類型 Terraform 引數 說明
api_root_url 選用,可更新 字串 api_root_url Bitbucket API 的 URL,例如 https://api.bitbucket.org
default_branch 選用,可更新 字串 default_branch 預設分支的名稱,例如 main
enable_traceability 可選,可更新,Default: false 布林 enable_traceability 將此值設為 true 以透過在提交、拉取請求和引用問題上建立標記、標籤和註釋來追蹤程式碼變更的部署。
git_id 選用,不可變 字串 git_id 針對 bitbucket.org,將此值設為 bitbucketgit,或設為自訂 Bitbucket 伺服器的 GUID。
has_issues 可選,可更新,Default: true 布林 toolchain_issues_enabled 將此值設為 true,以在 Bitbucket 儲存庫上啟用問題,並將「問題」工具卡新增至工具鏈。 將此值設為 false 可從工具鏈中移除工具整合卡。 此設定不會影響 Bitbucket 儲存庫本身是否啟用「問題」。
integration_owner 選用,可更新 字串 integration_owner 執行 Git 作業的使用者。
owner_id 選用,不可變 字串 owner_id 擁有儲存庫的 Bitbucket 使用者或群組。 當您建立儲存庫或複製或分出儲存庫時,需要此參數。 當您鏈結至現有儲存庫時,會計算此值。
private_repo 可選,不可變,Default: false 布林 private_repo 將此值設為 true,以在您建立儲存庫時,或在您複製或分出儲存庫時,將儲存庫設為專用。 當您鏈結至現有儲存庫時,不會使用此參數。
repo_id 選用,不可變 字串 repo_id Bitbucket 儲存庫的 ID。
repo_name 選用,不可變 字串 repo_name 要建立的 Bitbucket 儲存庫的名稱。 當您建立儲存庫或複製或分出儲存庫時,需要此參數。 當您鏈結至現有儲存庫時,會計算此值。
repo_url 選用,不可變 字串 repo_url 此工具整合的 Bitbucket 儲存庫 URL。 鏈結至現有儲存庫時需要此參數。 當您建立儲存庫或複製或分出儲存庫時,會計算此值。
source_repo_url 選用,不可變 字串 source_repo_url 您要分出或複製之儲存庫的 URL。 當您分出或複製儲存庫時需要此參數,但當您建立儲存庫或鏈結至現有儲存庫時不會使用此參數。
token_url 選用,可更新 字串 token_url 用來向 Bitbucket 伺服器授權的記號 URL。
類型 必要,不可變 字串 類型 要執行以起始設定新工具整合的作業。 使用 new 來建立 Git 儲存庫,clone 將現有儲存庫複製到新的 Git 儲存庫,fork 以分出現有 Git 儲存庫,或者 link 以鏈結至現有 Git 儲存庫。

進一步瞭解 Bitbucket

若要進一步瞭解 Bitbucket,請參閱 Bitbucket Cloud 資源