11.2. MicroShift での Operator Lifecycle Manager の使用

手順

1. 次のコマンドを使用して、OLM が実行されていることを確認します。

   $ oc -n openshift-operator-lifecycle-manager get pod -l app=olm-operator

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                            READY   STATUS    RESTARTS   AGE
   olm-operator-85b5c6786-n6kbc    1/1     Running   0          2m24s

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを使用して、OLM カタログ Operator が実行されていることを確認します。

   $ oc -n openshift-operator-lifecycle-manager get pod -l app=catalog-operator

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                                READY   STATUS    RESTARTS   AGE
   catalog-operator-5fc7f857b6-tj8cf   1/1     Running   0          2m33s

   Copy to Clipboard Toggle word wrap

1. 次のサンプル YAML を使用して、CatalogSource オブジェクトを作成します。

   カタログソース YAML の例

   apiVersion: operators.coreos.com/v1alpha1
   kind: CatalogSource
   metadata:
     name: operatorhubio-catalog
     namespace: openshift-marketplace 

   1

   
   spec:
     sourceType: grpc
     image: quay.io/operatorhubio/catalog:latest
     displayName: Community Operators 

   2

   
     publisher: OperatorHub.io
     grpcPodConfig:
       securityContextConfig: restricted 

   3

   
     updateStrategy:
       registryPoll:
         interval: 60m

   Copy to Clipboard Toggle word wrap

   1

   グローバル namespace。metadata.namespace を openshift-marketplace に設定すると、カタログがすべての namespace で実行できるようになります。どの namespace のサブスクリプションでも、openshift-marketplace namespace で作成されたカタログを参照できます。

   2

   コミュニティー Operator は、デフォルトでは MicroShift の OLM とともにインストールされません。ここには一例として記載されています。

   3

   securityContextConfig の値は、MicroShift に対して restricted に設定する必要があります。

2. 次のコマンドを実行して、CatalogSource 設定を適用します。

   $ oc apply -f <catalog_source.yaml> 

   1

   Copy to Clipboard Toggle word wrap

   1

   <catalog-source.yaml> をカタログソース設定ファイル名に置き換えます。この例では、catalogsource.yaml が使用されます。

   出力例

   catalogsource.operators.coreos.com/operatorhubio-catalog created

   Copy to Clipboard Toggle word wrap

3. カタログソースが適用されていることを確認するには、次のコマンドを使用して READY 状態を確認します。

   $ oc describe catalogsources.operators.coreos.com -n openshift-marketplace operatorhubio-catalog

   Copy to Clipboard Toggle word wrap

   出力例

   Name:         operatorhubio-catalog
   Namespace:    openshift-marketplace
   Labels:       <none>
   Annotations:  <none>
   API Version:  operators.coreos.com/v1alpha1
   Kind:         CatalogSource
   Metadata:
     Creation Timestamp:  2024-01-31T09:55:31Z
     Generation:          1
     Resource Version:    1212
     UID:                 4edc1a96-83cd-4de9-ac8c-c269ca895f3e
   Spec:
     Display Name:  Community Operators
     Grpc Pod Config:
       Security Context Config:  restricted
     Image:                      quay.io/operatorhubio/catalog:latest
     Publisher:                  OperatorHub.io
     Source Type:                grpc
     Update Strategy:
       Registry Poll:
         Interval:  60m
   Status:
     Connection State:
       Address:              operatorhubio-catalog.openshift-marketplace.svc:50051
       Last Connect:         2024-01-31T09:55:57Z
       Last Observed State:  READY 

   1

   
     Registry Service:
       Created At:         2024-01-31T09:55:31Z
       Port:               50051
       Protocol:           grpc
       Service Name:       operatorhubio-catalog
       Service Namespace:  openshift-marketplace
   Events:                 <none>

   Copy to Clipboard Toggle word wrap

   1

   ステータスは READY と報告されます。

4. 次のコマンドを使用して、カタログソースが実行されていることを確認します。

   $ oc get pods -n openshift-marketplace -l olm.catalogSource=operatorhubio-catalog

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                          READY   STATUS    RESTARTS   AGE
   operatorhubio-catalog-x24nh   1/1     Running   0          59s

   Copy to Clipboard Toggle word wrap

5. 次の YAML 例を使用して、Subscription CR 設定ファイルを作成します。

   サブスクリプションカスタムリソース YAML の例

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: my-cert-manager
     namespace: openshift-operators
   spec:
     channel: stable
     name: cert-manager
     source: operatorhubio-catalog
     sourceNamespace: openshift-marketplace 

   1

   Copy to Clipboard Toggle word wrap

   1

   グローバル namespace。sourceNamespace 値を openshift-marketplace に設定すると、カタログも openshift-marketplace namespace で実行される場合に、Operator を複数の namespace で実行できるようになります。

6. 次のコマンドを実行して、Subscription CR 設定を適用します。

   $ oc apply -f <subscription_cr.yaml> 

   1

   Copy to Clipboard Toggle word wrap

   1

   <subscription_cr.yaml> を Subscription CR ファイル名に置き換えます。

   出力例

   subscription.operators.coreos.com/my-cert-manager created

   Copy to Clipboard Toggle word wrap

7. 使用する特定のオペランドの設定ファイルを作成し、今すぐ適用できます。

検証

1. 次のコマンドを使用して、Operator が実行されていることを確認します。

   $ oc get pods -n openshift-operators 

   1

   Copy to Clipboard Toggle word wrap

   1

   Subscription CR の namespace が使用されます。

   注記

   Operator が開始するまで 1 - 2 分ほどお待ちください。

   出力例

   NAME                                       READY   STATUS    RESTARTS   AGE
   cert-manager-7df8994ddb-4vrkr              1/1     Running   0          19s
   cert-manager-cainjector-5746db8fd7-69442   1/1     Running   0          18s
   cert-manager-webhook-f858bf58b-748nt       1/1     Running   0          18s

   Copy to Clipboard Toggle word wrap

手順

1. 次のコマンドを使用して、OLM が実行されていることを確認します。

   $ oc -n openshift-operator-lifecycle-manager get pod -l app=olm-operator

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                           READY   STATUS    RESTARTS   AGE
   olm-operator-85b5c6786-n6kbc   1/1     Running   0          16m

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを使用して、OLM カタログ Operator が実行されていることを確認します。

   $ oc -n openshift-operator-lifecycle-manager get pod -l app=catalog-operator

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                                READY   STATUS    RESTARTS   AGE
   catalog-operator-5fc7f857b6-tj8cf   1/1     Running   0          16m

   Copy to Clipboard Toggle word wrap

3. 次の YAML 例を使用して、namespace を作成します。

   namespace YAML の例

   apiVersion: v1
   kind: Namespace
   metadata:
     name: olm-microshift

   Copy to Clipboard Toggle word wrap

4. 次のコマンドを使用して、namespace 設定を適用します。

   $ oc apply -f <ns.yaml> 

   1

   Copy to Clipboard Toggle word wrap

   1

   <ns.yaml> を namespace 設定ファイルの名前に置き換えます。この例では、olm-microshift が使用されます。

   出力例

   namespace/olm-microshift created

   Copy to Clipboard Toggle word wrap

5. 次の YAML 例を使用して、Operator グループ YAML を作成します。

   Operator グループ YAML の例

   kind: OperatorGroup
   apiVersion: operators.coreos.com/v1
   metadata:
     name: og
     namespace: olm-microshift
   spec: 

   1

   
     targetNamespaces:
     - olm-microshift

   Copy to Clipboard Toggle word wrap

   1

   グローバル namespace を使用する Operator の場合は、spec.targetNamespaces フィールドと値を省略します。

6. 次のコマンドを実行して、Operator グループ設定を適用します。

   $ oc apply -f <og.yaml> 

   1

   Copy to Clipboard Toggle word wrap

   1

   <og.yaml> を Operator グループ設定ファイルの名前に置き換えます。

   出力例

   operatorgroup.operators.coreos.com/og created

   Copy to Clipboard Toggle word wrap

7. 次のサンプル YAML を使用して、CatalogSource オブジェクトを作成します。

   カタログソース YAML の例

   apiVersion: operators.coreos.com/v1alpha1
   kind: CatalogSource
   metadata:
     name: operatorhubio-catalog
     namespace: openshift-marketplace 

   1

   
   spec:
     sourceType: grpc
     image: quay.io/operatorhubio/catalog:latest
     displayName: Community Operators 

   2

   
     publisher: OperatorHub.io
     grpcPodConfig:
       securityContextConfig: restricted 

   3

   
     updateStrategy:
       registryPoll:
         interval: 60m

   Copy to Clipboard Toggle word wrap

   1

   グローバル namespace。metadata.namespace を openshift-marketplace に設定すると、カタログがすべての namespace で実行できるようになります。任意の namespace の Subscription CR は、openshift-marketplace namespace で作成されたカタログを参照できます。

   2

   コミュニティー Operator は、デフォルトでは MicroShift の OLM とともにインストールされません。ここには一例として記載されています。

   3

   securityContextConfig の値は、MicroShift に対して restricted に設定する必要があります。

8. 次のコマンドを実行して、CatalogSource 設定を適用します。

   $ oc apply -f <catalog_source.yaml> 

   1

   Copy to Clipboard Toggle word wrap

   1

   <catalog_source.yaml> をカタログソース設定ファイル名に置き換えます。

9. カタログソースが適用されていることを確認するには、次のコマンドを使用して READY 状態を確認します。

   $ oc describe catalogsources.operators.coreos.com -n openshift-marketplace operatorhubio-catalog

   Copy to Clipboard Toggle word wrap

   出力例

   Name:         operatorhubio-catalog
   Namespace:    openshift-marketplace
   Labels:       <none>
   Annotations:  <none>
   API Version:  operators.coreos.com/v1alpha1
   Kind:         CatalogSource
   Metadata:
     Creation Timestamp:  2024-01-31T10:09:46Z
     Generation:          1
     Resource Version:    2811
     UID:                 60ce4a36-86d3-4921-b9fc-84d67c28df48
   Spec:
     Display Name:  Community Operators
     Grpc Pod Config:
       Security Context Config:  restricted
     Image:                      quay.io/operatorhubio/catalog:latest
     Publisher:                  OperatorHub.io
     Source Type:                grpc
     Update Strategy:
       Registry Poll:
         Interval:  60m
   Status:
     Connection State:
       Address:              operatorhubio-catalog.openshift-marketplace.svc:50051
       Last Connect:         2024-01-31T10:10:04Z
       Last Observed State:  READY 

   1

   
     Registry Service:
       Created At:         2024-01-31T10:09:46Z
       Port:               50051
       Protocol:           grpc
       Service Name:       operatorhubio-catalog
       Service Namespace:  openshift-marketplace
   Events:                 <none>

   Copy to Clipboard Toggle word wrap

   1

   ステータスは READY と報告されます。

10. 次のコマンドを使用して、カタログソースが実行されていることを確認します。

    $ oc get pods -n openshift-marketplace -l olm.catalogSource=operatorhubio-catalog

    Copy to Clipboard Toggle word wrap

    出力例

    NAME                          READY   STATUS    RESTARTS   AGE
    operatorhubio-catalog-j7sc8   1/1     Running   0          43s

    Copy to Clipboard Toggle word wrap

11. 次の YAML 例を使用して、Subscription CR 設定ファイルを作成します。

    サブスクリプションカスタムリソース YAML の例

    apiVersion: operators.coreos.com/v1alpha1
    kind: Subscription
    metadata:
      name: my-gitlab-operator-kubernetes
      namespace: olm-microshift 

    1

    
    spec:
      channel: stable
      name: gitlab-operator-kubernetes
      source: operatorhubio-catalog
      sourceNamespace: openshift-marketplace 

    2

    Copy to Clipboard Toggle word wrap

    1

    特定の namespace。Operator はコンテンツのグローバル namespace を参照しますが、olm-microshift namespace で実行されます。

    2

    グローバル namespace。任意の namespace の Subscription CR は、openshift-marketplace namespace で作成されたカタログを参照できます。

12. 次のコマンドを実行して、Subscription CR 設定を適用します。

    $ oc apply -f <subscription_cr.yaml> 

    1

    Copy to Clipboard Toggle word wrap

    1

    <subscription_cr.yaml> を Subscription CR 設定ファイルの名前に置き換えます。

    出力例

    subscription.operators.coreos.com/my-gitlab-operator-kubernetes

    Copy to Clipboard Toggle word wrap

13. 使用する特定のオペランドの設定ファイルを作成し、今すぐ適用できます。

検証

1. 次のコマンドを使用して、Operator が実行されていることを確認します。

   $ oc get pods -n olm-microshift 

   1

   Copy to Clipboard Toggle word wrap

   1

   Subscription CR の namespace が使用されます。

   注記

   Operator が開始するまで 1 - 2 分ほどお待ちください。

   出力例

   NAME                                         READY   STATUS    RESTARTS   AGE
   gitlab-controller-manager-69bb6df7d6-g7ntx   2/2     Running   0          3m24s

   Copy to Clipboard Toggle word wrap