配置 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）的基於網頁的託管服務。您可以同時具有儲存庫的本端及遠端副本。欲了解更多資訊，請參閱 Git Repos and Issue Tracking。

如果您要在建立工具鏈時配置 Git Repos and Issue Tracking，請遵循下列步驟：

在「可配置的整合」區段中，按一下 Git Repos and Issue Tracking。
檢閱 Git 儲存庫的預設目標位置。那些儲存庫是從範例儲存庫中複製而來。必要的話，請變更目標儲存庫的名稱。

如果您有工具鏈，並且要將工具鏈中的 Git 儲存庫移轉至 Git Repos and Issue Tracking，請遵循下列步驟：

這些指示適用於已包含您要移轉至 Git Repos and Issue Tracking 的 Git 儲存庫的工具鏈。有關將不同類型的 Git 儲存庫加入工具鏈的資訊，請參閱《設定》 GitHub 與《設定》 GitLab。

從 IBM Cloud 控制台點擊選單圖示（）> 平台自動化 > 工具鏈。在「工具鏈」頁面中，點擊該工具鏈以開啟其「概覽」頁面。
按一下新增。
在「工具整合」區段中，按一下 Git Repos and Issue Tracking。
選取您要在其中部署程式碼變更的伺服器。建立整合之後，您可以編輯它，以管理您已獲授權使用的伺服器清單。按一下 管理授權，以檢視所有伺服器的清單，並刪除您提供以向伺服器授權的記號。
若要建立 Git 儲存庫的副本，請針對儲存庫類型按一下複製。鍵入新的儲存庫名稱，以及來源儲存庫的 URL。
系統會自動選取您的使用者名稱，以將此新整合的所有權指派給您自己。建立整合之後，另一個授權使用者可以在編輯整合時，將整合的所有權重新指派給他們自己。
如果您要建立專用儲存庫，請選取 將此儲存庫設為專用 勾選框。
若要使用 Issues 進行問題追蹤，請選取啟用 Issues 勾選框。
若要透過建立確定的標籤和註解以及確定所參照之問題的標籤和註解來追蹤程式碼變更部署，請選取追蹤程式碼變更部署勾選框。
按一下建立整合。

在您複製 Git 儲存庫之後，即可從工具鏈中將它移除。

如果您有工具鏈，並且要新增 Git Repos and Issue Tracking 到其中，請遵循下列步驟：

從 IBM Cloud 控制台點擊選單圖示（）> 平台自動化 > 工具鏈。在「工具鏈」頁面中，點擊該工具鏈以開啟其「概覽」頁面。
點擊「新增工具」。
在「工具整合」區段中，按一下 Git Repos and Issue Tracking。
選取您要在其中部署程式碼變更的伺服器。建立整合之後，您可以編輯它，以管理您已獲授權使用的伺服器清單。按一下 管理授權，以檢視所有伺服器的清單，並刪除您提供以向伺服器授權的記號。
選取儲存庫類型：

a. 若要建立空的儲存庫，請針對儲存庫類型按一下新建，然後鍵入儲存庫名稱。 b. 若要分出 Git 儲存庫，以透過合併要求來提出變更，請針對儲存庫類型按一下分出。鍵入來源儲存庫的 URL。 c. 若要建立 Git 儲存庫的副本，請針對儲存庫類型按一下複製。鍵入新的儲存庫名稱，以及來源儲存庫的 URL。 d. 如果您有 Git 儲存庫並且想要使用它，請針對儲存庫類型按一下現有。鍵入來源儲存庫的 URL。
系統會自動選取您的使用者名稱，以將此新整合的所有權指派給您自己。建立整合之後，另一個授權使用者可以在編輯整合時，將整合的所有權重新指派給他們自己。
如果您要建立專用儲存庫，請選取 將此儲存庫設為專用 勾選框。
若要使用 Issues 進行問題追蹤，請選取啟用 Issues 勾選框。
若要透過建立確定的標籤和註解以及確定所參照之問題的標籤和註解來追蹤程式碼變更部署，請選取追蹤程式碼變更部署勾選框。
按一下建立整合。
從工具鏈的「概觀」頁面中，在 儲存庫 卡上，按一下您要使用的 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 根路徑網址	URL 的 Git Repos and Issue Tracking API。
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	此工具整合的 Git Repos and Issue Tracking repo 的 URL。鏈結至現有儲存庫時需要此參數。當您建立儲存庫或複製或分出儲存庫時，會計算此值。
原始碼儲存庫網址	選用，不可變	字串	原始碼儲存庫網址	您要 fork 或 clone 的 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 驗證方法與 Trusted Profiles.The Personal Access Token (PAT) 驗證不相容，您可以使用 GUI、API 或 Terraform 設定 Git Repos and Issue Tracking 工具的整合。這是因為 PAT 與擁有可信設定檔的實際使用者綁定。使用者可以使用個人存取權限，在工具鏈中建立或重新設定 Git Repos and Issue Tracking 工具整合。不過，他們應該以一般使用者的身分登入，才能存取實際的 Git repo UI。