資源

Config Connector 包含多個自訂資源定義 (CRD) 集合。每個 CRD 都允許您設定 Kubernetes 的 Google Cloud資源。Config Connector 也讓您可以利用多項 Kubernetes 功能來管理 Google Cloud 資源。

本頁面將介紹 Config Connector 如何使用 Kubernetes 物件及其中繼資料。

Kubernetes 物件和 Config Connector 資源

舉例來說，當您建立 kind: SQLInstance 的 Kubernetes 物件時，Config Connector 會建立 Cloud SQL 執行個體。本節說明 Config Connector 如何擴充物件類型。

規格和狀態

每個 Config Connector 資源都是一個Kubernetes 物件，其中包含 Spec 和 Status。

規格
spec 欄位包含所有定義物件所需狀態的欄位，但 Labels 除外。spec 的子欄位會參照相關的 Google Cloud 資源。變更子欄位時， Google Cloud 資源的值會最終與您指定的值一致。
SQLInstance 資源中的 databaseVersion 就是可寫欄位的範例。
狀態
status 欄位為唯讀，且包含物件的目前狀態。Config Connector 會定期讀取 Google Cloud資源的資訊，並更新 status。您可以查看 Status.Condition，檢查資源的錯誤訊息或就緒狀態。
範例唯讀 status 欄位是 SQLInstance 資源的 connectionName。

物件中繼資料

每個 Config Connector 資源都包含中繼資料欄位。本節說明 Config Connector 如何在 metadata 中使用子欄位。

名稱
Config Connector 資源的名稱。應遵循 Kubernetes 物件名稱的命名慣例。預設會用來做為對應 Google Cloud 資源的名稱。如果 Config Connector 資源支援 resourceID 欄位，您可以為 spec.resourceID 欄位中的對應 Google Cloud 資源，指定不同的名稱，並遵循 Google Cloud資源的命名慣例。詳情請參閱「使用 resourceID 欄位管理資源」。
命名空間
您建立 Config Connector 資源的命名空間，會決定包含 Google Cloud 資源的專案。如要進一步瞭解命名空間，請參閱「Kubernetes 命名空間和 Google Cloud 專案」。
標籤
Config Connector 資源中繼資料欄位的標籤也會新增至相關聯的 Google Cloud 資源。
此外，Config Connector 會為您的 Google Cloud 資源新增名為 managed-by-cnrm 的系統標籤，其值為 true。
註解
Config Connector 可對 spec 中未定義的資源採取其他動作。這些動作是在 metadata.annotations 的子欄位中定義。註解值「必須」是字串。如要瞭解 Config Connector 支援的註解類型，請參閱「註解」。

資料夾和階層資源

除了管理 Google Cloud 產品中的資源，Config Connector 也支援在Google Cloud 資料夾和機構中建立及管理資源。詳情請參閱「命名空間和專案」。

使用 RBAC 控管存取權

Kubernetes 的角色型存取權控管 (RBAC) 可保護您的資源。您可以指派 RBAC 權限，控管 Google Cloud資源的建立作業。詳情請參閱「保護資源存取權」。

狀態條件

Config Connector 會在 status.condition 中使用就緒條件，目的有二：

  • 表示資源何時就緒。當資源完成比對並準備就緒時，其 status.condition.status 會設為 True。如要查看資源何時就緒，請參閱「等待資源就緒」
  • 顯示其他錯誤或資訊。就緒條件包含 Message 和 Reason 欄位，可提供資源狀態的其他資訊。

事件

Config Connector 資源的重要狀態變更會顯示為 Kubernetes 事件。詳情請參閱「查看事件」。

宣告式設定和最終一致性

請參閱「對帳」。

後續步驟