리소스

Config Connector에는 커스텀 리소스 정의(CRD) 모음이 포함되어 있습니다. 각 CRD에서 Kubernetes의 Google Cloud 리소스를 구성할 수 있습니다. Google Cloud 리소스를 관리하기 위해 Config Connector에서 여러 Kubernetes 기능을 활용할 수도 있습니다.

이 페이지에서는 Config Connector가 Kubernetes 객체 및 해당 메타데이터를 사용하는 방법을 소개합니다.

Kubernetes 객체 및 Config Connector 리소스

예를 들어 kind: SQLInstanceKubernetes 객체를 만들면 Config Connector가 Cloud SQL 인스턴스를 만듭니다. 이 섹션에서는 Config Connector가 객체 유형을 확장하는 방법에 대해 설명합니다.

사양 및 상태

각 Config Connector 리소스는 SpecStatus를 가진 Kubernetes 개체입니다.

사양
spec 필드는 Labels를 제외하고 원하는 객체 상태를 정의하는 모든 필드를 포함합니다. spec의 하위 필드는 연관된 Google Cloud 리소스를 나타냅니다. 하위 필드를 변경하면 Google Cloud 리소스의 값이 의도한 값과 eventual consistency를 갖습니다.
쓰기 가능한 필드의 예는 SQLInstance 리소스의 databaseVersion입니다.
상태
status 필드는 읽기 전용이며 객체의 현재 상태를 포함합니다. Config Connector는 주기적으로 Google Cloud 리소스에 대한 정보를 읽고 status을 업데이트합니다. Status.Condition을 보고 리소스의 오류 메시지 또는 준비 상태를 확인합니다.
읽기 전용 status 필드의 예는 SQLInstance 리소스의 connectionName입니다.

객체 메타데이터

각 Config Connector 리소스에는 메타데이터 필드가 포함됩니다. 이 섹션에서는 Config Connector가 메타데이터 내에서 하위 필드를 사용하는 방법에 대해 설명합니다.

이름
Config Connector 리소스의 이름입니다. Kubernetes 객체 이름의 이름 지정 규칙을 따라야 합니다. 기본적으로 해당 Google Cloud 리소스 이름으로 사용됩니다. resourceID 필드가 Config Connector 리소스에서 지원되는 경우 Google Cloud 리소스의 해당 이름 지정 규칙에 따라 해당 Google Cloud 리소스의 spec.resourceID 필드에 다른 이름을 지정할 수 있습니다. 자세한 내용은 resourceID 필드로 리소스 관리를 참조하세요.
네임스페이스
Config Connector 리소스를 생성하는 네임스페이스에 따라 Google Cloud 리소스가 포함된 프로젝트가 결정됩니다. 네임스페이스에 대한 자세한 내용은 Kubernetes 네임스페이스 및 Google Cloud 프로젝트를 참조하세요.
라벨
Config Connector 리소스의 메타데이터 필드에 있는 라벨도 관련 Google Cloud 리소스에 추가됩니다.
또한 Config Connector는 true 값을 가진 managed-by-cnrm 시스템 라벨을 Google Cloud 리소스에 추가합니다.
주석
구성 커넥터는 spec에 정의되지 않은 리소스에 대해 추가 조치를 취할 수 있습니다. 이러한 조치는 metadata.annotations의 하위 필드에 정의되어 있습니다. 주석 값은 반드시 문자열이어야 합니다. Config Connector가 지원하는 주석 유형은 주석에 설명되어 있습니다.

폴더 및 계층 리소스

Config Connector는 Google Cloud 제품의 리소스 관리 외에도 Google Cloud 폴더 및 조직 내에서 리소스 생성 및 관리를 지원합니다. 자세한 정보는 네임스페이스 및 프로젝트를 참조하세요.

액세스 제어에 RBAC 사용

Kubernetes 역할 기반 액세스 제어(RBAC)는 리소스를 보호합니다. RBAC 권한을 할당하여 Google Cloud 리소스 생성을 제어할 수 있습니다. 자세한 정보는 리소스에 대한 액세스 보안을 참조하세요.

상태 조건

Config Connector는 다음 두 목적에 대해 status.condition의 준비 조건을 사용합니다.

  • 리소스가 준비되었을 때 이를 알립니다. 리소스가 조정되었고 준비되었으면 해당 status.condition.statusTrue로 설정됩니다. 리소스가 준비되었는지 확인하려면 리소스 준비 대기를 참조하세요.
  • 추가 오류 또는 정보 표시. 준비 조건에는 리소스 상태에 대해 추가 정보를 제공하는 MessageReason 필드가 포함됩니다.

이벤트

구성 커넥터 리소스에 대한 중요한 상태 변경사항은 Kubernetes 이벤트로 표시됩니다. 자세한 정보는 이벤트 보기를 참조하세요.

선언적 구성 및 eventual consistency

조정을 참조하세요.

다음 단계