2.2. Operator Framework 打包格式

捆绑包清单是 Operator 捆绑包中的 Kubernetes 对象，它为 Operator 定义部署和基于角色的访问控制(RBAC)模型。捆绑包包含一个集群服务版本(CSV)，通常是其 /manifests 目录中该 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 依赖项定义 Operator Lifecycle Manager (OLM)必须在 OpenShift Container Platform 上安装过程中解析的 Operator 之间的关系。您可以在捆绑包的 metadata/ 文件夹中的 optional 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 是一个 Operator Framework 工具，用于从 OpenShift Container Platform 中的捆绑包镜像创建和维护 Operator 目录。您可以使用它来构建 Operator Lifecycle Manager (OLM)通过目录源引用的目录容器镜像。

目录包含一个指向 Operator 清单内容的指针数据库，可通过在运行容器镜像时提供的已包含 API 进行查询。在 OpenShift Container Platform 中，Operator Lifecycle Manager (OLM) 可以引用由 CatalogSource 对象定义的目录源中的镜像，它会定期轮询镜像，以对集群上安装的 Operator 进行更新。