管理套件

本頁說明如何透過 Google Cloud 控制台,使用 Config Sync 管理套件。

事前準備

部署套件

將叢集註冊至機群並安裝 Config Sync 後,您就可以設定 Config Sync,從可靠來源將套件部署至叢集。您可以將相同套件部署至多個叢集,也可以將不同套件部署至不同叢集。部署套件後,您可以編輯套件,但無法變更套件名稱和同步類型等設定。詳情請參閱「管理套件」。

如要部署套件,請完成下列步驟:

  1. 前往 Google Cloud 控制台的 Config Sync 資訊主頁

    前往 Config Sync 資訊主頁

  2. 按一下「部署套件」

  3. 在「選取叢集來部署套件」資料表中,選取要部署套件的叢集,然後按一下「繼續」

  4. 選取「Package hosted on Git」或「Package hosted on OCI」做為來源類型,然後按一下「繼續」

  5. 在「套件詳細資料」部分,輸入「套件名稱」,用於識別 RootSync 或 RepoSync 物件。

  6. 在「同步類型」欄位中,選擇「叢集範圍同步」或「命名空間範圍同步」做為同步類型。

    叢集範圍同步會建立 RootSync 物件,命名空間範圍同步則會建立 RepoSync 物件。 如要進一步瞭解這些物件,請參閱「Config Sync 架構」。

  7. 在「來源」部分,完成下列步驟:

    • 如要使用 Git 存放區中託管的來源,請填寫下列欄位:

      1. 在「存放區網址」中,輸入做為資料來源的 Git 存放區網址。
      2. 選用:更新「修訂版本」欄位,確認您是否未使用預設的 HEAD
      3. 選用:如不想從根存放區同步處理,請更新「路徑」欄位。
      4. 選用:如未使用預設的 main 分支版本,請更新「分支版本」欄位。
    • 如要使用 OCI 映像檔代管的來源,請輸入下列欄位:

      1. 輸入做為可靠資料來源的 OCI 映像檔網址,做為「映像檔」
      2. 輸入要同步的目錄路徑 (相對於根目錄),做為「目錄」
  8. (選用):展開「進階設定」部分,完成下列操作:

    1. 選取「驗證類型」。Config Sync 需要您可靠來源的唯讀存取權,才能讀取來源中的設定檔,並將這些檔案套用至叢集。除非來源不需要驗證 (例如公開存放區),否則請務必授予 Config Sync 對 Git 存放區OCI 映像檔Helm 資訊套件的唯讀存取權 (僅限 gcloud CLI)。選擇您在安裝 Config Sync 時設定的驗證類型:

      • :不使用任何驗證機制。
      • SSH:使用 SSH 金鑰組進行驗證。
      • Cookiefile:使用 cookiefile 進行驗證。
      • 權杖:使用存取權杖或密碼進行驗證。
      • Google Cloud Repository:使用 Google 服務帳戶存取 Cloud Source Repositories 存放區。只有在叢集啟用 Workload Identity Federation for GKE 時,才選取這個選項。
      • Workload Identity:使用 Google 服務帳戶存取 Cloud Source Repositories 存放區。
    2. 輸入秒數來設定「同步等待時間」,決定 Config Sync 嘗試從可靠資料來源提取資料時的等待時間。

    3. 輸入 Git Proxy 網址,供與資料來源通訊時使用 HTTPS Proxy。

  9. 按一下「部署套件」

    系統會將您重新導向至 Config Sync「Packages」頁面。幾分鐘後,您設定的叢集在「同步處理狀態」欄中應會顯示「已同步處理」

編輯套件

如要編輯已部署的套件,請完成下列步驟:

  1. 在 Google Cloud 控制台中,前往 Config Sync「Packages」(套件) 分頁。

    前往「Packages」(套件) 頁面

  2. (選用):展開「快速篩選器」選單,然後選取篩選器,協助找出要編輯的套裝組合。

  3. 展開要編輯的套件名稱,然後在包含叢集名稱的列中,按一下內容選單 ,再按一下 「編輯套件」

  4. 查看並更新要變更的套裝組合設定。

  5. 按一下 [儲存]

解除安裝套件

如要從 Google Cloud 控制台解除安裝套件,請完成下列步驟:

  1. 在 Google Cloud 控制台中,前往 Config Sync「Packages」(套件) 分頁。

    前往「Packages」(套件) 頁面

  2. (選用):展開「快速篩選器」選單,然後選取篩選器,協助找出要解除安裝的套件。

  3. 展開要解除安裝的套件名稱,然後在包含叢集名稱的資料列中,依序點按內容選單 「解除安裝套件」

  4. 在確認對話方塊中,選取要只解除安裝 RootSync 或 RepoSync 物件, 還是要解除安裝 RootSync 或 RepoSync RootSync 或 RepoSync 管理的所有資源。

  5. 輸入確認訊息,然後按一下「解除安裝」

後續步驟