資源

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 會定期讀取資源資訊，並更新 status。 Google Cloud如要查看資源的錯誤訊息或準備狀態，請查看 Status.Condition。
唯讀 status 欄位的範例是 SQLInstance 資源的 connectionName。connectionName

物件中繼資料

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

名稱
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。如要查看資源何時準備就緒，請參閱「等待資源準備就緒」一節。
  • 顯示其他錯誤或資訊。ready 條件具有 Message 和 Reason 欄位，可提供資源狀態的額外資訊。

活動

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

宣告式設定和最終一致性

請參閱「對帳」。

後續步驟