1.2.15.6. 読み取り専用 Operator API (テクノロジープレビュー)

手順

1. OLM の Cluster Version Operator (CVO) 管理 を無効にします。

   $ oc patch clusterversion version \
       --type=merge -p \
       '{
          "spec":{
             "overrides":[
                {
                   "kind":"Deployment",
                   "name":"olm-operator",
                   "namespace":"openshift-operator-lifecycle-manager",
                   "unmanaged":true,
                   "group":"apps/v1"
                }
             ]
          }
       }'

2. OperatorLifecycleManagerV2=true 機能ゲートを OLM Operator に追加します。

   1. OLM Operator のデプロイメントを編集します。

      $ oc -n openshift-operator-lifecycle-manager \
          edit deployment olm-operator

   2. 以下のフラグをデプロイメントの args セクションに追加します。

      ...
          spec:
            containers:
            - args:
      ...
              - --feature-gates
              - OperatorLifecycleManagerV2=true

   3. 変更を保存します。
3. まだインストールしていない場合は、通常の OperatorHub メソッドを使用して Operator をインストールします。この例では、プロジェクト test-project にインストールされた etcd Operator を使用します。

4. インストールされた etcd Operator の新規 Operator リソースを作成します。

   1. 以下をファイルに保存します。

      etcd-test-op.yaml ファイル

      apiVersion: operators.coreos.com/v2alpha1
      kind: Operator
      metadata:
        name: etcd-test

   2. リソースを作成します。

      $ oc create -f etcd-test-op.yaml

5. インストールされた Operator の新規 API へのオプトインを可能にするには、operators.coreos.com/etcd-test ラベルを Operator に関連する以下のオブジェクトに適用します。

   • Subscription
   • InstallPlan
   • ClusterServiceVersion
   • Operator によって所有される CRD
   注記

   今後のリリースでは、これらのオブジェクトには Subscription オブジェクトを使用して CSV がインストールされている Operator についてのラベルが自動的に付けられます。

   以下は例になります。

   $ oc label sub etcd operators.coreos.com/etcd-test="" -n test-project
   $ oc label ip install-6c5mr operators.coreos.com/etcd-test="" -n test-project
   $ oc label csv etcdoperator.v0.9.4 operators.coreos.com/etcd-test="" -n test-project
   $ oc label crd etcdclusters.etcd.database.coreos.com operators.coreos.com/etcd-test=""
   $ oc label crd etcdbackups.etcd.database.coreos.com operators.coreos.com/etcd-test=""
   $ oc label crd etcdrestores.etcd.database.coreos.com operators.coreos.com/etcd-test=""

6. Operator が新規 API にオプトインしていることを確認します。

   1. すべての operators リソースを一覧表示します。

      $ oc get operators
      
      NAME        AGE
      etcd-test   17m

   2. Operator の詳細を検査し、ラベルを付けたオブジェクトが表示されていることを確認します。

      $ oc describe operators etcd-test

      Name:         etcd-test
      Namespace:
      Labels:       <none>
      Annotations:  <none>
      API Version:  operators.coreos.com/v2alpha1
      Kind:         Operator
      Metadata:
        Creation Timestamp:  2020-07-02T05:51:17Z
        Generation:          1
        Resource Version:    37727
        Self Link:           /apis/operators.coreos.com/v2alpha1/operators/etcd-test
        UID:                 6a441a4d-75fe-4224-a611-7b6c83716909
      Status:
        Components:
          Label Selector:
            Match Expressions:
              Key:       operators.coreos.com/etcd-test
              Operator:  Exists
          Refs:
            API Version:  apiextensions.k8s.io/v1
            Conditions:
              Last Transition Time:  2020-07-02T05:50:40Z
              Message:               no conflicts found
              Reason:                NoConflicts
              Status:                True
              Type:                  NamesAccepted
              Last Transition Time:  2020-07-02T05:50:41Z
              Message:               the initial names have been accepted
              Reason:                InitialNamesAccepted
              Status:                True
              Type:                  Established
            Kind:                    CustomResourceDefinition
            Name:                    etcdclusters.etcd.database.coreos.com 

      1

      
      ...
            API Version:             operators.coreos.com/v1alpha1
            Conditions:
              Last Transition Time:  2020-07-02T05:50:39Z
              Message:               all available catalogsources are healthy
              Reason:                AllCatalogSourcesHealthy
              Status:                False
              Type:                  CatalogSourcesUnhealthy
            Kind:                    Subscription
            Name:                    etcd 

      2

      
            Namespace:               test-project
      ...
            API Version:             operators.coreos.com/v1alpha1
            Conditions:
              Last Transition Time:  2020-07-02T05:50:43Z
              Last Update Time:      2020-07-02T05:50:43Z
              Status:                True
              Type:                  Installed
            Kind:                    InstallPlan
            Name:                    install-mhzm8 

      3

      
            Namespace:               test-project
      ...
            Kind:                    ClusterServiceVersion
            Name:                    etcdoperator.v0.9.4 

      4

      
            Namespace:               test-project
      Events:                        <none>

      1

      いずれかの CRD

      2

      Subscription オブジェクト。

      3

      InstallPlan オブジェクト。

      4

      CSV。