本頁說明如何從 Google Cloud 控制台使用 Config Sync 管理套件。
套件是一組 Kubernetes 資源物件資訊清單,這些資訊清單會在可靠資料來源中管理,並由 Config Sync 同步至叢集。每個套件定義都包含在叢集上的 RootSync 或 RepoSync 物件中。如要進一步瞭解 RootSync 和 RepoSync 物件,請參閱 Config Sync 架構。
事前準備
部署套件
將叢集註冊至機群並安裝 Config Sync 後,您就能設定 Config Sync,從可靠來源將套件部署至叢集。您可以將相同套件部署至多個叢集,也可以將不同套件部署至不同叢集。部署套件後,您可以編輯套件,但無法變更套件名稱和同步類型等部分設定。詳情請參閱「管理套件」。
如要部署套件,請完成下列步驟:
前往 Google Cloud 控制台的 Config Sync 資訊主頁。
按一下「Deploy Package」(部署套件)。
在「Select clusters for package deployment」(選取叢集來部署套件) 表格中,選取要部署套件的叢集,然後按一下「Continue」(繼續)。
選取「Package hosted on Git」(Git 上託管的套件) 或「Package hosted on OCI」(OCI 上託管的套件) 做為來源類型,然後按一下「繼續」。
在「套件詳細資料」部分,輸入「套件名稱」,用於識別 RootSync 或 RepoSync 物件。
在「Sync type」(同步類型) 欄位中,選擇「Cluster scoped sync」(叢集範圍同步) 或「Namespace scoped sync」(命名空間範圍同步) 做為同步類型。
叢集範圍同步會建立 RootSync 物件,命名空間範圍同步則會建立 RepoSync 物件。 如要進一步瞭解這些物件,請參閱「Config Sync 架構」。
在「來源」部分,完成下列步驟:
如要使用 Git 存放區中託管的來源,請填寫下列欄位:
- 輸入做為資料來源的 Git 存放區網址做為「存放區網址」。
- 選用:更新「修訂版本」欄位,確認您是否未使用預設的
HEAD
。 - 選用:如不想從根存放區同步處理,請更新「路徑」欄位。
- 選用:如果您未使用預設的
main
分支版本,請更新「分支版本」欄位。
如要使用 OCI 映像檔代管的來源,請輸入下列欄位:
- 輸入做為可靠資料來源的 OCI 圖片網址,做為「圖片」。
- 輸入要同步的目錄路徑 (相對於根目錄),做為「目錄」。
(選用):展開「進階設定」部分,完成下列步驟:
選取「驗證類型」。Config Sync 需要您可靠來源的唯讀權限,才能讀取來源中的設定檔,並將這些檔案套用至叢集。除非來源不需要驗證 (例如公開存放區),否則請務必授予 Config Sync 對 Git 存放區、OCI 映像檔或 Helm 資訊套件 (僅限 gcloud CLI) 的唯讀存取權。選擇與安裝 Config Sync 時設定的驗證類型相同:
- 無:不使用任何驗證機制。
- SSH:使用 SSH 金鑰組進行驗證。
- Cookiefile:使用
cookiefile
進行驗證。 - 權杖:使用存取權杖或密碼進行驗證。
- Google Cloud Repository:使用 Google 服務帳戶存取 Cloud Source Repositories 存放區。只有在叢集未啟用 GKE 的工作負載身分聯盟時,才選取這個選項。
- Workload Identity:使用 Google 服務帳戶存取 Cloud Source Repositories 存放區。
輸入秒數來設定「同步等待時間」,決定 Config Sync 嘗試從可靠資料來源提取資料時的等待時間。
輸入 Git Proxy 網址,供 HTTPS Proxy 在與資料來源通訊時使用。
選擇「階層」即可變更「來源格式」。
在大多數情況下,建議使用預設值「非結構化」,因為這樣您就能隨意整理單一事實來源。
按一下「Deploy Package」(部署套件)。
系統會將您重新導向至 Config Sync「Packages」(套件) 頁面。幾分鐘後,您設定的叢集在「Sync status」(同步處理狀態)欄中應會顯示「Synced」(已同步處理)。
編輯套件
如要編輯已部署的套件,請完成下列步驟:
在 Google Cloud 控制台中,前往 Config Sync 的「Packages」(套件) 分頁。
(選用):展開「快速篩選器」選單,然後選取篩選器,協助找出要編輯的套裝組合。
展開要編輯的套件名稱,然後在包含叢集名稱的列中,按一下內容選單 more_vert,接著按一下 edit「編輯套件」。
查看並更新要變更的套裝組合設定。
按一下 [儲存]。
解除安裝套件
如要從 Google Cloud 控制台解除安裝套件,請完成下列步驟:
在 Google Cloud 控制台中,前往 Config Sync 的「Packages」(套件) 分頁。
(選用):展開「快速篩選器」選單,然後選取篩選器,找出要解除安裝的套件。
展開要解除安裝的套件名稱,然後在包含叢集名稱的資料列中,按一下內容選單 more_vert,接著按一下 delete「解除安裝套件」。
在確認對話方塊中,選取要只解除安裝 RootSync 或 RepoSync 物件, 還是要解除安裝 RootSync 或 RepoSync 和 RootSync 或 RepoSync 管理的所有資源。
輸入確認訊息,然後按一下「解除安裝」。