12.4. ClusterServiceVersion (CSV) の生成

• operator.yaml
• *_{crd,cr}.yaml
• RBAC ロールファイル (例: role.yaml)

• 既存の場所および命名規則と同じ設定で、YAML マニフェストおよびソースファイルの利用可能なデータを使用して新規 CSV を作成します。

  1. 更新メカニズムは、deploy/ で既存の CSV の有無をチェックします。これが見つからない場合、ここでは キャッシュ と呼ばれる ClusterServiceVersion オブジェクトを作成し、Kubernetes API ObjectMeta などの Operator メタデータから派生するフィールドを簡単に設定できます。
  2. 更新メカニズムは、deploy/ で Deployment リソースなどの CSV が使用するデータが含まれるマニフェストを検索し、このデータを使ってキャッシュ内の該当する CSV フィールドを設定します。
  3. 検索が完了したら、設定されたすべてのキャッシュフィールドが CSV YAML ファイルに書き込まれます。

• YAML マニフェストおよびソースファイルで利用可能なデータを使用して、現時点で事前に定義されている場所で既存の CSV を更新します。

  1. 更新メカニズムは、deploy/ で既存の CSV の有無をチェックします。これが見つかる場合、CSV YAML ファイルのコンテンツは ClusterServiceVersion キャッシュにマーシャルされます。
  2. 更新メカニズムは、deploy/ で Deployment リソースなどの CSV が使用するデータが含まれるマニフェストを検索し、このデータを使ってキャッシュ内の該当する CSV フィールドを設定します。
  3. 検索が完了したら、設定されたすべてのキャッシュフィールドが CSV YAML ファイルに書き込まれます。

追加リソース

• Operator 成熟度モデル

前提条件

• Operator プロジェクトが Operator SDK を使用して生成されている

• 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) で指定します。

• Operator が使用する必要のあるイメージを挿入する環境変数を宣言する際に Operator Deployment の env セクションで、以下を実行します。

  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) で Operator コンテナーイメージを参照します。

前提条件

• CSV を含む Operator プロジェクト
• 複数のアーキテクチャーおよびオペレーティングシステムの一覧表示をサポートするには、CSV で参照される Operator イメージはマニフェスト一覧イメージである必要があります。
• Operator がネットワークが制限された環境または非接続環境で適切に機能できるようにするには、参照されるイメージは、タグではなくダイジェスト (SHA) を使用して指定される必要もあります。

手順

• Operator がサポートするサポートされるアーキテクチャーおよびオペレーティングシステムのそれぞれについて CSV の metadata.labels にラベルを追加します。

  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 仕様を参照してください。