2.2. Operator 프레임워크 패키지 형식

번들 매니페스트는 Operator 번들에 있는 Kubernetes 오브젝트로, Operator의 deployment 및 ROLE 기반 액세스 제어(RBAC) 모델을 정의합니다. 번들에는 하나의 CSV(클러스터 서비스 버전)와 일반적으로 해당 CSV가 보유한 API의 CRD(사용자 정의 리소스 정의)가 / 매니페스트 디렉터리에 포함됩니다.

etcd
├── manifests
│   ├── etcdcluster.crd.yaml
│   └── etcdoperator.clusterserviceversion.yaml
│   └── secret.yaml
│   └── configmap.yaml
└── metadata
    └── annotations.yaml
    └── dependencies.yaml

metadata/annotations.yaml 파일의 Operator 번들 주석은 번들 인덱싱 방법을 설명하는 집계 메타데이터를 정의합니다. 이러한 주석은 미디어 유형, 매니페스트 경로, 패키지 이름, 채널, 카탈로그 등록을 위한 기본 채널을 지정합니다.

번들에 /metadata 디렉터리에 annotations.yaml 파일이 포함되어 있습니다.

annotations:
  operators.operatorframework.io.bundle.mediatype.v1: "registry+v1"
  operators.operatorframework.io.bundle.manifests.v1: "manifests/"
  operators.operatorframework.io.bundle.metadata.v1: "metadata/"
  operators.operatorframework.io.bundle.package.v1: "test-operator"
  operators.operatorframework.io.bundle.channels.v1: "beta,stable"
  operators.operatorframework.io.bundle.channel.default.v1: "stable"

다음과 같습니다.

Operator 종속 항목은 OpenShift Container Platform에 설치하는 동안 OLM(Operator Lifecycle Manager)에서 확인해야 하는 Operator 간의 관계를 정의합니다. 번들의 metadata/ 폴더에 있는 선택적 dependencies.yaml 파일에 이러한 종속 항목을 나열할 수 있습니다.

종속성 목록에는 종속성의 유형을 지정하기 위해 각 항목에 대한 type 필드가 포함되어 있습니다. 다음과 같은 유형의 Operator 종속 항목이 지원됩니다.

다음 예제에서는 Prometheus Operator 및 etcd CRD에 대한 종속 항목을 지정합니다.

dependencies:
  - type: olm.package
    value:
      packageName: prometheus
      version: ">0.27.0"
  - type: olm.gvk
    value:
      group: etcd.database.coreos.com
      kind: EtcdCluster
      version: v1beta2

opm CLI는 OpenShift Container Platform의 번들 이미지에서 Operator 카탈로그를 생성하고 유지 관리하는 Operator 프레임워크 툴입니다. 이 이미지를 사용하여 OLM(Operator Lifecycle Manager)이 카탈로그 소스를 통해 참조하는 카탈로그 컨테이너 이미지를 빌드할 수 있습니다.

카탈로그에는 컨테이너 이미지가 실행될 때 제공되는 포함된 API를 통해 쿼리할 수 있는 Operator 매니페스트 콘텐츠에 대한 포인터 데이터베이스가 포함되어 있습니다. OpenShift Container Platform에서 OLM(Operator Lifecycle Manager)은 CatalogSource 오브젝트에서 정의한 카탈로그 소스의 이미지를 참조할 수 있으며 주기적으로 이미지를 폴링하여 클러스터에 설치된 Operator를 자주 업데이트할 수 있습니다.