9.3. oc-mirror プラグインを使用したカスタム Operator カタログの作成

手順

1. 次のコマンドを実行して、フィルタリング可能な Red Hat 提供の Operator カタログのリストを取得します。

   $ oc mirror list operators --version 4.18 --catalogs

2. 次のコマンドを実行して、Red Hat Operators カタログの Operator の一覧を取得します。

   $ oc mirror list operators <--catalog=<catalog_source>> 

   1

   1

   registry.redhat.io/redhat/redhat-operator-index:v4.18 または quay.io/operatorhubio/catalog:latest などのカタログソースを指定します。

3. Operator を選択します。この例では、amq-broker-rhel9 Operator を使用します。

4. オプション: フィルタリングする Operator のチャネルとバージョンを検査するには、次のコマンドを入力します。

   1. 次のコマンドを実行して、チャネルのリストを取得します。

      $ oc mirror list operators --catalog=registry.redhat.io/redhat/redhat-operator-index:v4.18 --package=amq-broker-rhel9

   2. 次のコマンドを実行して、チャネル内のバージョンのリストを取得します。

      $ oc mirror list operators --catalog=registry.redhat.io/redhat/redhat-operator-index:v4.18 --package=amq-broker-rhel9 --channel=7.13.x

手順

1. 次の例をガイドとして使用して、MicroShift の ImageSetConfiguration YAML を作成して編集します。

   編集された MicroShift イメージセット設定ファイルの例

   kind: ImageSetConfiguration
   apiVersion: mirror.openshift.io/v2alpha1
   mirror:
     operators:
     - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.18 

   1

   
       packages:
       - name: amq-broker-rhel9 

   2

   
         channels:
         - name: 7.13.x 

   3

   
     additionalImages: 

   4

   
      - name: quay.io/rh_ee_aguidi/multi-platform-container:latest
      - name: quay.io/rh_ee_aguidi/empty-image:latest

   1

   イメージを取得する Operator カタログを設定します。

   2

   イメージセットに含める Operator パッケージを指定します。カタログ内のすべてのパッケージを取得するには、このフィールドを削除してください。

   3

   イメージセットに含める Operator パッケージの特定のチャネルのみを指定します。そのチャネルでバンドルを使用しない場合も、常に Operator パッケージのデフォルトチャネルを含める必要があります。oc mirror list operators --catalog=<catalog_name> --package=<package_name> コマンドを実行すると、デフォルトチャネルを見つけることができます。

   4

   イメージセットに含める追加のイメージを指定します。追加のイメージを指定する必要がない場合は、このフィールドを削除してください。

   重要

   プラットフォーム フィールド、関連フィールド、および Helm は MicroShift ではサポートされていません。

2. 更新されたファイルを ImageSetConfiguration.yaml として保存します。

検証

1. 次のコマンドを実行して、cluster-resources サブディレクトリーの内容を一覧表示します。

   $ ls <v2_workspace>/working-dir/cluster-resources/ 

   1

   1

   &lt ;v2_workspace> は、ミラーリングプロセスのカスタムリソースを保存するために使用したディレクトリーに置き換えます。

手順

1. 次のコマンドを実行して、ImageDigestMirrorSet YAML ファイルの内容を確認します。

   $ cat <v2_workspace>/working-dir/cluster-resources/imagedigestmirrorset.yaml 

   1

   1

   &lt ;v2_workspace> を、ミラーリングリソースを生成したときに使用したディレクトリー名に置き換えます。

   出力例

   apiVersion: config.openshift.io/v1
   kind: ImageDigestMirrorSet
   metadata:
     labels:
       operators.openshift.org/catalog: "true"
     name: operator-0
   spec:
     imageDigestMirrors:
     - mirrors:
       - registry.example.com/amq7
       source: registry.redhat.io/amq7

2. 次のコマンドを実行して、imagedigestmirrorset.yaml を CRI-O 設定の準備が整った形式に変換します。

   yq '.spec.imageDigestMirrors[] as $item ireduce([]; . + [{"mirror": $item.mirrors[], "source": ($item | .source)}]) | .[] |
     "[[registry]]
         prefix = \"" + .source + "\"
         location = \"" + .mirror + "\"
         mirror-by-digest-only = true
         insecure = true
         "' ./mirror1/working-dir/cluster-resources/imagedigestmirrorset.yaml

   出力例

   [[registry]]
         prefix = "registry.redhat.io/amq7"
         location = "registry.example.com/amq7"
         mirror-by-digest-only = true
         insecure = true

3. /etc/containers/registries.conf.d/ ディレクトリーの CRI-O 設定ファイルに出力を追加します。

   crio-config.yaml ミラー設定ファイルの例

   [[registry]]
         prefix = "registry.redhat.io/amq7"
         location = "registry.example.com/amq7"
         mirror-by-digest-only = true
         insecure = true
   
   [[registry]]
       prefix = ""
       location = "quay.io"
       mirror-by-digest-only = true
   [[registry.mirror]]
       location = "<registry_host>:<port>" 

   1

   
       insecure = false

   1

   ミラーレジストリーサーバーのホスト名およびポートを指定します（例： microshift-quay:8443 ）。

4. 次のコマンドで MicroShift を再起動して、CRI-O 設定の変更を適用します。

   $ sudo systemctl restart crio

手順

1. 次のコマンドを実行して、results ディレクトリーからカタログソース設定ファイルを適用し、カタログソースオブジェクトを作成します。

   $ oc apply -f ./<v2_workspace>/working-dir/cluster-resources/catalogSource-cs-redhat-catalog.yaml 

   1

   1

   &lt ;v2_workspace> は、ミラーリングプロセスのカスタムリソースを保存するために使用したディレクトリーに置き換えます。

   出力例

   catalogsource.operators.coreos.com/cs-redhat-catalog created

2. 詳細は、以下のサンプルファイルを参照してください。

   カタログソース設定ファイルの例

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

   1

   
   spec:
     sourceType: grpc
     image: registry.example.com/redhat/redhat-catalog:v4.18
     updateStrategy:
       registryPoll:
         interval: 60m

   1

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

3. 以下のコマンドを実行して、CatalogSource リソースが正常にインストールされたことを確認します。

   $ oc get catalogsource --all-namespaces

   出力例

   NAMESPACE               NAME                  DISPLAY               TYPE   PUBLISHER   AGE
   openshift-marketplace   certified-operators   Certified Operators   grpc   Red Hat     37m
   openshift-marketplace   community-operators   Community Operators   grpc   Red Hat     37m
   openshift-marketplace   redhat-marketplace    Red Hat Marketplace   grpc   Red Hat     37m
   openshift-marketplace   redhat-catalog        Red Hat Catalog     grpc   Red Hat     37m

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

   $ oc get pods -n openshift-marketplace

   出力例

   NAME                             READY   STATUS    RESTARTS   AGE
   cs-redhat-catalog-4227b   2/2     Running   0          2m5s

5. 次の例のような Subscription CR を作成します。

   Subscription CR の例

   apiVersion: operators.coreos.com/v2alpha1
   kind: Subscription
   metadata:
     name: amq-broker
     namespace: openshift-operators
   spec:
     channel: 7.13.x
     name: amq-broker-rhel9
     source: cs-redhat-catalog
     sourceNamespace: openshift-marketplace

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

   $ oc apply -f ./<subscription_cr.yaml> 

   1

   1

   <subscription _cr.yaml> でサブスクリプションの名前を指定します （例： amq-​broker-subscription-cr.yaml ）。

   出力例

   subscription.operators.coreos.com/amq-broker created