5.7.2. 수동으로 정의한 CSV 필드

대부분의 CSV 필드는 Operator SDK와 관련 없이 생성된 일반 매니페스트를 사용하여 채울 수 없습니다. 이러한 필드는 대부분 Operator 및 다양한 CRD(사용자 정의 리소스 정의)에 대해 사람이 작성한 메타데이터입니다.

Operator 작성자는 CSV(클러스터 서비스 버전) YAML 파일을 직접 수정하여 다음과 같은 필수 필드에 개인화된 데이터를 추가해야 합니다. Operator SDK는 필수 필드에서 데이터 부족이 탐지되는 경우 CSV 생성 중 경고를 표시합니다.

다음 테이블에는 필수 또는 선택적인 수동 정의 CSV 필드가 자세히 설명되어 있습니다.

Expand

표 5.7. 필수 CSV 필드
필드	설명
`metadata.name`	이 CSV의 고유 이름입니다. 고유성을 유지하도록 이름에 Operator 버전이 포함되어야 합니다(예: `app-operator.v0.1.1)`.
`metadata.capabilities`	Operator 완성 모델에 따른 기능 수준입니다. 옵션에는 `Basic Install`, `Seamless Upgrades`, `Full Lifecycle`, `Deep Insights`, `Auto Pilot`이 있습니다.
`spec.displayName`	Operator를 확인하는 공용 이름입니다.
`spec.description`	Operator 기능에 대한 간단한 설명입니다.
`spec.keywords`	Operator를 설명하는 키워드입니다.
`spec.maintainers`	`name` 및 `email`을 사용하여 Operator를 유지 관리하는 사람 또는 조직 엔티티입니다.
`spec.provider`	`name`이 있는 Operator의 공급자입니다(일반적으로 조직).
`spec.labels`	Operator 내부에서 사용할 키-값 쌍입니다.
`spec.version`	Operator의 의미 체계 버전입니다(예: `0.1.1`).
`spec.customresourcedefinitions`	Operator에서 사용하는 모든 CRD입니다. CRD YAML 파일이 `deploy/`에 있는 경우 이 필드는 Operator SDK에 의해 자동으로 채워집니다. 그러나 CRD 매니페스트 사양에 없는 몇몇 필드에는 사용자 입력이 필요합니다. `description`: CRD 설명입니다. `resources`: CRD에서 활용하는 모든 Kubernetes 리소스입니다(예: `Pod` 및 `StatefulSet` 오브젝트). `specDescriptors`: Operator의 입력 및 출력에 대한 UI 힌트입니다.

Expand

표 5.8. 선택적 CSV 필드
필드	설명
`spec.replaces`	CSV 이름이 이 CSV로 교체됩니다.
`spec.links`	Operator 또는 애플리케이션과 관련된 URL(예: 웹 사이트 및 문서)을 각각 `name` 및 `url`을 사용하여 관리합니다.
`spec.selector`	Operator에서 클러스터의 리소스와 연결할 수 있는 선택기입니다.
`spec.icon`	Operator 고유의 base64로 인코딩된 아이콘으로, `mediatype`을 사용하여 `base64data` 필드에 설정됩니다.
`spec.maturity`	이 버전의 소프트웨어에서 달성한 완성 수준입니다. 옵션에는 `planning`, `pre-alpha`, `alpha`, `beta`, `stable`, `mature`, `inactive`, `deprecated`가 포함됩니다.

위의 각 필드에 보관해야 하는 데이터에 대한 자세한 내용은 CSV 사양에서 확인할 수 있습니다.

참고

현재 사용자 개입이 필요한 여러 YAML 필드를 Operator 코드에서 구문 분석할 수 있습니다.