12.4. 生成 ClusterServiceVersion (CSV)

• operator.yaml
• *_{crd,cr}.yaml
• RBAC 角色文件，如 role.yaml

• 使用 YAML 清单和源文件中的可用数据新建一个 CSV，其位置和命名约定与当前存在的信息相同。

  1. 该更新机制会检查 deploy/ 中是否存在现有 CSV。如果未找到，便会创建一个 ClusterServiceVersion 对象，这里称为 cache，并填充容易从 Operator 元数据派生的字段，如 Kubernetes API ObjectMeta。
  2. 更新机制在 deploy/ 中搜索包含 CSV 所用数据（如 Deployment 资源）的清单，并使用该数据设置 cache 中的适当 CSV 字段。
  3. 搜索完成后，每个填充的 cache 字段都会写回到 CSV YAML 文件中。

• 使用 YAML 清单和源文件中的可用数据更新当前预定义位置的现有 CSV。

  1. 该更新机制会检查 deploy/ 中是否存在现有 CSV。找到后，CSV YAML 文件内容会被封送至 ClusterServiceVersion cache 中。
  2. 更新机制在 deploy/ 中搜索包含 CSV 所用数据（如 Deployment 资源）的清单，并使用该数据设置 cache 中的适当 CSV 字段。
  3. 搜索完成后，每个填充的 cache 字段都会写回到 CSV YAML 文件中。

其他资源

• Operator 成熟度模型

先决条件

• 使用 Operator SDK 生成一个 Operator 项目

• 列出 Operator 执行其功能可能需要的任何 相关镜像或其他容器镜像。
• 通过摘要 (SHA) 而不是标签来引用所有指定的镜像。

• 在 spec.relatedImages 中:

  ...
  spec:
    relatedImages: 1
      - name: etcd-operator 2
        image: quay.io/etcd-operator/operator@sha256:d134a9865524c29fcf75bbc4469013bc38d8a15cb5f41acfddb6b9e492f556e4 3
      - name: etcd-image
        image: quay.io/etcd-operator/etcd@sha256:13348c15263bd8838ec1d5fc4550ede9860fcbb0f843e48cbccec07810eebb68
  ...

  1

  创建 relatedImages 部分并设置相关镜像列表。

  2

  指定镜像的唯一标识符。

  3

  通过摘要 (SHA) 而不是通过镜像标签指定每个镜像。

• 在 Operators Deployment 的 env 部分中，声明环境变量，以注入 Operator 应使用的镜像：

  spec:
    install:
      spec:
        deployments:
        - name: etcd-operator-v3.1.1
          spec:
            replicas: 1
            selector:
              matchLabels:
                name: etcd-operator
            strategy:
              type: Recreate
            template:
              metadata:
                labels:
                  name: etcd-operator
              spec:
                containers:
                - args:
                  - /opt/etcd/bin/etcd_operator_run.sh
                  env:
                  - name: WATCH_NAMESPACE
                    valueFrom:
                      fieldRef:
                        fieldPath: metadata.annotations['olm.targetNamespaces']
                  - name: ETCD_OPERATOR_DEFAULT_ETCD_IMAGE 1
                    value: quay.io/etcd-operator/etcd@sha256:13348c15263bd8838ec1d5fc4550ede9860fcbb0f843e48cbccec07810eebb68 2
                  - name: ETCD_LOG_LEVEL
                    value: INFO
                  image: quay.io/etcd-operator/operator@sha256:d134a9865524c29fcf75bbc4469013bc38d8a15cb5f41acfddb6b9e492f556e4 3
                  imagePullPolicy: IfNotPresent
                  livenessProbe:
                    httpGet:
                      path: /healthy
                      port: 8080
                    initialDelaySeconds: 10
                    periodSeconds: 30
                  name: etcd-operator
                  readinessProbe:
                    httpGet:
                      path: /ready
                      port: 8080
                    initialDelaySeconds: 10
                    periodSeconds: 30
                  resources: {}
                serviceAccountName: etcd-operator
      strategy: deployment

  1

  通过环境变量注入 Operator 引用的镜像。

  2

  通过摘要 (SHA) 而不是通过镜像标签指定每个镜像。

  3

  另外，使用摘要(SHA)而不是镜像标签（tag）引用 Operator 容器镜像。

先决条件

• 包含 CSV 的 Operator 项目
• 要支持列出多个架构和操作系统，CSV 中引用的 Operator 镜像必须是清单列表镜像。
• 要使 Operator 在受限网络或断开连接的环境中正常工作，还必须使用摘要（SHA）而不是标签（tag）来指定引用的镜像。

流程

• 在 CSV metadata.labels 中为每个 Operator 支持的架构和操作系统添加标签：

  labels:
    operatorframework.io/arch.s390x: supported
    operatorframework.io/os.zos: supported
    operatorframework.io/os.linux: supported 1
    operatorframework.io/arch.amd64: supported 2

  1 2

  在添加新的构架或操作系统后，您必须明确包含默认的 os.linux 和 arch.amd64 变体。

其他资源

• 如需有关清单列表的更多信息 ，请参阅Image Manifest V 2, Schema 2 说明。