7.6. イメージセット設定の作成

手順

1. oc mirror init コマンドを使用して、イメージセット設定のテンプレートを作成し、それを imageset-config.yaml というファイルに保存します。

   $ oc mirror init --registry <storage_backend> > imageset-config.yaml --v1

   ここでは、以下のようになります。

   < ストレージバックエンド >

   ストレージバックエンドのロケーションを指定します (例: example.com/mirror/oc-mirror-metadata)。

2. ファイルを編集し、必要に応じて設定を調整します。

   kind: ImageSetConfiguration
   apiVersion: mirror.openshift.io/v1alpha2
   archiveSize: 4
   storageConfig:
     registry:
       imageURL: example.com/mirror/oc-mirror-metadata
       skipTLS: false
   mirror:
     platform:
       channels:
       - name: stable-4.20
         type: ocp
       graph: true
     operators:
     - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.20
       packages:
       - name: serverless-operator
         channels:
         - name: stable
     additionalImages:
     - name: registry.redhat.io/ubi9/ubi:latest
   # ...

   ここでは、以下のようになります。

   archiveSize

   archiveSize を 指定することで、イメージセット内の各ファイルの最大サイズを GiB 単位で設定します。

   storageConfig

   イメージセットのメタデータを保存するバックエンドの場所を指定します。この場所は、レジストリーまたはローカルディレクトリーにすることができます。storageConfig 値を指定する必要があります。

   storageConfig.registry.imageURL

   ストレージバックエンドのレジストリー URL を指定します。

   mirror.platform.channels.name

   OpenShift Container Platform イメージを取得するチャネルを指定します。

   mirror.platform.graph

   グラフデータイメージをビルドしてミラーレジストリーにプッシュするには、graph: true を指定します。OpenShift Update Service (OSUS) を作成するには、graph-data イメージが必要です。graph: true フィールドは UpdateService カスタムリソースマニフェストも生成します。oc コマンドラインインターフェイス (CLI) は、UpdateService カスタムリソースマニフェストを使用して OSUS を作成できます。詳細は、OpenShift Update Service について を参照してください。

   mirror.operators.catalog

   OpenShift Container Platform イメージを取得する Operator カタログを指定します。

   mirror.operators.packages.name

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

   mirror.operators.packages.channels.name

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

   mirror.additionalImages.name

   イメージセットに含める追加イメージを指定します。

   注記

   graph: true フィールドは、他のミラーリングされたイメージとともに ubi-micro イメージもミラーリングします。

   OpenShift Container Platform Extended Update Support (EUS) バージョンをアップグレードする場合、現行バージョンとターゲットバージョンの間に中間バージョンが必要になる場合があります。たとえば、最新バージョンが 4.14 で、ターゲットバージョンが 4.16 の場合、oc-mirror プラグイン v1 の使用時に ImageSetConfiguration に 4.15.8 などのバージョンを含める必要がある場合があります。

   oc-mirror プラグイン v1 は必ずしもこれを自動的に検出するとは限りません。Cincinnati graph の Web ページで 必要な中間バージョンを確認し、手動で設定に追加してください。

   パラメーターの完全なリストは、「イメージセットの設定パラメーター」を参照してください。また、さまざまなミラーリングのユースケースは、「イメージセットの設定例」を参照してください。

3. 更新したファイルを保存します。

   このイメージセット設定ファイルは、コンテンツをミラーリングするときに oc mirror コマンドで必要になります。