透過 Automation Pipelines,可以在 Gerrit 專案中進行代碼檢閱時觸發管線。適用於 Gerrit 的觸發器定義包括 Gerrit 專案和必須針對不同事件類型執行的管線。

適用於 Gerrit 的觸發器在將要監控的 Gerrit 伺服器上使用 Gerrit 接聽程式。若要在 Automation Pipelines 中定義 Gerrit 端點,您可以選取專案,並輸入 Gerrit 伺服器的 URL。然後,在該伺服器上建立 Gerrit 接聽程式時指定端點。

以下程序說明如何定義可在 Gerrit 接聽程式定義中使用的 Gerrit 端點。如果需要編輯端點,程序結束時會有一個可選步驟說明如何以及何時執行更新。

必要條件

程序

  1. 定義 Gerrit 端點。
    1. 按一下設定 > 端點,然後按一下新增端點
    2. 選取專案,針對端點類型選取 Gerrit。然後,輸入名稱與說明。
    3. 如果此端點是您基礎結構中的業務關鍵元件,請啟用標記為受限制
    4. 輸入 Gerrit 伺服器的 URL。
      若要使用預設連接埠,您可以提供帶有 URL 的連接埠號碼或將該值留空。
    5. 輸入 Gerrit 伺服器的使用者名稱和密碼。
      如果必須加密密碼,請按一下 建立變數,然後選取類型:
      • 密碼。當具有任何角色的使用者執行管線時,密碼即會解析。
      • 受限制。當具有管理員角色的使用者執行管線時,密碼即會解析。

      對於值,請輸入必須是安全的密碼,例如 Jenkins 伺服器的密碼。

    6. 對於私密金鑰,輸入用於安全存取 Gerrit 伺服器的 SSH 金鑰。
      此金鑰是位於 .ssh 目錄中的 RSA 私密金鑰。
    7. (選擇性) 如果複雜密碼與私密金鑰相關聯,請輸入複雜密碼。
      若要加密複雜密碼,請按一下 建立變數並選取類型:
      • 密碼。當具有任何角色的使用者執行管線時,密碼即會解析。
      • 受限制。當具有管理員角色的使用者執行管線時,密碼即會解析。

      對於值,請輸入必須是安全的複雜密碼,例如 SSH 伺服器的複雜密碼。

  2. 按一下驗證,然後確認 Automation Pipelines 中的 Gerrit 端點是否連線至 Gerrit 伺服器。
    如果無法連線,請更正任何錯誤,然後再次按一下 驗證
    為 Gerrit 觸發器新增端點時,您必須確認 Gerrit 端點會連線至 Gerrit 伺服器。
  3. 按一下建立
  4. (選擇性) 更新 Gerrit 端點 (例如變更 URL 或私密金鑰) 之前,請檢查該端點是否已連線到 Gerrit 接聽程式。
    • 如果該端點未連線到 Gerrit 接聽程式,請執行以下步驟以更新端點:
      1. 按一下設定 > 端點,然後在要更新的端點上按一下開啟
      2. 更新端點定義。
      3. (選擇性) 如果要變更雲端 Proxy,請將舊雲端 Proxy 重新啟動一次以移除任何舊連線,然後再啟動新的雲端 Proxy 並建立新連線。
      4. 按一下驗證以確認 Automation Pipelines 中的 Gerrit 端點是否連線至 Gerrit 伺服器。
      5. 按一下儲存
    • 如果該端點已連線到 Gerrit 接聽程式,請執行以下步驟以更新端點:
      1. 將任何連結的 Gerrit 接聽程式中斷連線。請參閱如何在 Automation Pipelines 中使用 Gerrit 觸發器執行管線
      2. 執行以下步驟以設定新端點。
      3. (選擇性) 如果要變更雲端 Proxy,請將舊雲端 Proxy 重新啟動一次以移除任何舊連線,然後再啟動新的雲端 Proxy 並建立新連線。
      4. 驗證並儲存更新的端點定義。
      5. 再次連線 Gerrit 接聽程式。
      備註: 如果 Gerrit 接聽程式未中斷連線,可能是因為目前 Gerrit 端點值已變更,接聽程式無法再與 Gerrit 伺服器通訊。如果出現此問題,請先在端點定義中進行變更,以便接聽程式可以與 Gerrit 伺服器通訊。將 Gerrit 接聽程式中斷連線,然後再重新連線。

下一步

若要進一步瞭解,請檢閱其他區段。請參閱如何在 Automation Pipelines 中使用 Gerrit 觸發器執行管線