配置 GitLab

Continuous Delivery 將於 2027 年 2 月 12 日在下列地區停用：烏-水, 鈣門, ca-tor, 美國東部。 Code Risk Analyzer 和 DevOps Insights 也將於該日在所有地區停用。 但是，如果某一區域沒有活躍使用這些功能，則該區域的功能可能會提早停止使用，並停止接受新的實體。 進一步瞭解

GitLab 是 Git 儲存庫的 Web 型管理服務。 您可以同時具有儲存庫的本端和遠端副本，方便進行分工合作。

您可以將 GitLab 配置為工具鏈中的工具整合，以在 GitLab.com 或公司 GitLab 實例的新或現有儲存庫中管理原始碼。 透過 Wiki、問題追蹤及合併要求來參與社交編碼。

如果您要在建立工具鏈時配置此工具整合，請遵循下列步驟：

  1. 如果您是將原始碼儲存至 GitLab 儲存庫，請按一下「可配置的整合」區段中的 GitLab。 如果您要在 IBM Cloud Public 上設定此工具整合，您必須授權 IBM Cloud 存取 GitLab，方法是選擇 OAuth****或個人存取權限。

    • 如果您選擇 OAuth，請按一下授權進入 GitLab 網站。 如果您沒有作用中的 GitLab 階段作業，則系統會提示您登入。 按一下授權應用程式，以容許 IBM Cloud 存取 GitLab 帳戶。 如果您有作用中的 GitLab 階段作業，但最近未輸入過密碼，則系統可能會提示您輸入 GitLab 密碼進行確認。

    • 如果您選擇「個人存取記號」，則必須輸入個人存取記號，以用來授權 GitLab 複製儲存庫並代表您執行其他動作。 如果您沒有個人存取記號，則可以遵循 GitLab 網站上的文件來建立個人存取記號。 請確定您的個人存取記號具有 api 權限。

  2. 如果您要在自己的 GitLab 伺服器上使用儲存庫，請按一下「可配置的整合」區段中的新增自訂伺服器。

    a. 為您的自訂 GitHub 伺服器輸入標題，指定伺服 URL 器的根目錄，並輸入您的個人存取權杖。

    b. 如果您沒有個人存取記號，則可以遵循 GitLab 網站上的文件來建立個人存取記號。

    c. 如果您的GitHub伺服器是氣隙的或無法在公共互聯網上訪問，您可以連接並整合Delivery Pipeline Private Worker 以在您自己的Kubernetes基礎設施上運行，以訪問內部或本地資源。 有關Delivery Pipeline私有工作器的更多信息，請參閱 使用Delivery Pipeline私有工作器。

  3. 檢閱 GitLab 儲存庫的預設目標儲存庫位置。 那些儲存庫是從範例儲存庫中複製而來。 必要的話，請變更目標儲存庫的名稱。

如果您有工具鏈，並且要新增此工具整合到其中，請遵循下列步驟：

  1. 從 IBM Cloud 控制台點擊選單圖示（漢堡圖示 ）> 平台自動化 > 工具鏈。 在「工具鏈」頁面中，點擊該工具鏈以開啟其「概覽」頁面。

  2. 點選「新增工具」。

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

  4. 按一下您要使用的 GitLab 伺服器。

  5. 如果您有 GitLab 儲存庫並且想要使用它，請針對儲存庫類型按一下現有，然後鍵入 URL。

  6. 如果您要使用新的 GitLab 儲存庫，請鍵入儲存庫的名稱，並鍵入您所複製或分出之儲存庫的 URL，然後選取儲存庫類型：

    a. 若要建立空的儲存庫，請按一下新建。

    b. 若要建立 GitLab 儲存庫的副本，請按一下複製。

    c. 若要分出 GitLab 儲存庫，以透過合併要求來提出變更，請按一下分出。

  7. 若要在伺服器上建立公用儲存庫，請清除將此儲存庫設為專用勾選框。

  8. 若要使用 GitLab Issues 進行問題追蹤，請選取啟用 GitLab Issues 勾選框。

  9. 若要透過建立確定的標籤和註解以及確定所參照之問題的標籤和註解來追蹤程式碼變更部署，請選取追蹤程式碼變更部署勾選框。

  10. 按一下建立整合。

  11. 從工具鏈的「概觀」頁面中，在 儲存庫 卡上，按一下您要使用的 GitLab 儲存庫。 根據您已選取的儲存庫，會開啟 GitLab 網站或公司的 GitLab 儲存庫，您可以在其中檢視儲存庫的內容。

  12. 如果您已啟用 GitLab Issues，請按一下 GitLab Issues 將它開啟。 您可以將此 GitLab Issues 實例用於整個工具鏈，即使工具鏈包含多個 GitLab 儲存庫。

    如果您沒有要鏈結之儲存庫的擁有者或主要專用權，則整合會受到限制，因為您無法使用 Webhook。 需要有 Webhook，才能在將確定推送至儲存庫時自動執行管線。 如果沒有 Webhook，您必須手動啟動管線。

使用 API 來配置 GitLab

工具 GitLab 整合支援下列配置參數，您可在 建立、讀取及 更新工具整合時，透過工具鏈 HTTP API 與 SDK 使用這些參數。

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

GitLab工具整合參數
參數 用法 類型 Terraform 引數 說明
API 根路徑網址 選用，可更新 字串 API 根路徑網址 該 API URL GitLab 的
API 金鑰 選用，可更新 密碼 API 金鑰 個人存取憑證（PAT）。 只有在 auth_type 設為 pat 時，才需要此參數，否則會忽略它。
AUTH_TYPE 選用，可更新，Default: oauth 字串 AUTH_TYPE 設定用來存取 Git 提供者的鑑別方法。
盲連接 選用，可更新，Default: false 布林 盲連接 將此值設為 true 表示伺服器無法在公共互聯網上尋址，因為IBM Cloud無法驗證您提供的連線詳細資訊。 某些需要 API 存取Git伺服器的功能將被停用。Delivery Pipeline只能透過使用具有Git伺服器網路存取權限的專用工作人員來運作。
預設分支 選用，可更新 字串 預設分支 Git 儲存庫的預設分支名稱。
enable_traceability 選用，可更新，Default: false 布林 enable_traceability 將此值設定為「true」，即可透過在提交、拉取請求及相關問題上建立標籤、標記和註解，來追蹤程式碼變更的部署狀況。
git_id 選用，不可變 字串 git_id 針對 gitlab.com，將此值設為 gitlab，或設為自訂 GitLab 伺服器的 GUID。
has_issues 選用，可更新，Default: true 布林 工具鏈問題啟用狀態 將此值設為 true，以在 GitLab 儲存庫上啟用「問題」，並將「問題」工具整合卡新增至工具鏈。 將此值設為 false 可從工具鏈中移除工具整合卡。 此動作不會影響 GitLab 儲存庫本身是否已啟用問題。
整合負責人 選用，可更新 字串 整合負責人 選取執行 Git 作業的使用者身分。
owner_id 選用，不可變 字串 owner_id 擁有儲存庫的 GitLab 使用者或群組。 當您建立儲存庫或複製或分出儲存庫時，需要此參數。 當您鏈結至現有儲存庫時，會計算此值。
私人儲存庫 選用，不可變，Default: true 布林 私人儲存庫 將此值設為 true，以在您建立儲存庫或複製或分出儲存庫時將儲存庫設為專用。 當您鏈結至現有儲存庫時，不會使用此參數。
repo_id 選用，不可變 字串 repo_id GitLab 專案的 ID。
repo_name 選用，不可變 字串 repo_name 要建立的 GitLab 儲存庫名稱。 當您建立儲存庫或複製或分出儲存庫時，需要此參數。 當您鏈結至現有儲存庫時，會計算此值。
repo_url 選用，不可變 字串 repo_url 此工具整合的存取 GitLab 權限 URL 設定。 鏈結至現有儲存庫時需要此參數。 當您建立儲存庫或複製或分出儲存庫時，會計算此值。
原始碼儲存庫網址 選用，不可變 字串 原始碼儲存庫網址 您要分叉或複製的儲存庫的 URL 連結。 當您分出或複製儲存庫時需要此參數，但當您建立儲存庫或鏈結至現有儲存庫時不會使用此參數。
代幣網址 選用，可更新 字串 代幣網址 用於向伺服器 GitLab 進行授權的 URL 憑證。
類型 必要，不可變 字串 類型 要執行以起始設定新工具整合的作業。 使用 new 來建立 Git 儲存庫，clone 將現有儲存庫複製到新的 Git 儲存庫，fork 以分出現有 Git 儲存庫，或者 link 以鏈結至現有 Git 儲存庫。