3.7. 非接続クラスターで使用する Operator カタログのミラーリング

手順

1. ミラーレジストリーに認証が必要な場合は、以下のコマンドを実行してレジストリーにログインします。

   $ podman login <mirror_registry>

   Copy to Clipboard Toggle word wrap

2. 以下のコマンドを実行して、コンテンツをミラーレジストリーに対して抽出し、ミラーリングします。

   $ oc adm catalog mirror \
       <index_image> \ 

   1

   
       <mirror_registry>:<port>[/<repository>] \ 

   2

   
       [-a ${REG_CREDS}] \ 

   3

   
       [--insecure] \ 

   4

   
       [--index-filter-by-os='<platform>/<arch>'] \ 

   5

   
       [--manifests-only] 

   6

   Copy to Clipboard Toggle word wrap

   1

   ミラーリングするカタログのインデックスイメージを指定します。

   2

   Operator の内容をミラーリングするターゲットレジストリーの完全修飾ドメイン名 (FQDN) を指定します。ミラーレジストリー <repository> には、前提条件で説明した olm-mirror など、レジストリー上の既存のリポジトリーまたは namespace を指定できます。ミラーリング中に既存のリポジトリーが見つかった場合は、そのリポジトリー名が結果のイメージ名に追加されます。イメージ名にリポジトリー名を含めたくない場合は、この行から <repository> 値を省略します (例: <mirror_registry>:<port>)。

   3

   オプション: 必要な場合は、レジストリー認証情報ファイルの場所を指定します。registry.redhat.io には、{REG_CREDS} が必要です。

   4

   オプション: ターゲットレジストリーの信頼を設定しない場合は、--insecure フラグを追加します。

   5

   オプション: 複数のバリアントが利用可能な場合に、選択するインデックスイメージのプラットフォームおよびアーキテクチャーを指定します。イメージは '<platform>/<arch>[/<variant>]' として渡されます。これはインデックスで参照されるイメージには適用されません。有効な値は、linux/amd64、linux/ppc64le、linux/s390x、linux/arm64 です。

   6

   オプション: 実際にイメージコンテンツをレジストリーにミラーリングせずに、ミラーリングに必要なマニフェストのみを生成します。このオプションは、ミラーリングする内容を確認するのに役立ちます。また、パッケージのサブセットのみが必要な場合に、マッピングのリストに変更を加えることができます。次に、mapping.txt ファイルを oc image mirror コマンドで使用し、後のステップでイメージの変更済みの一覧をミラーリングできます。これは、カタログからのコンテンツの高度な選択可能ミラーリングの実行に使用するためのフラグです。

   出力例

   src image has index label for database path: /database/index.db
   using database path mapping: /database/index.db:/tmp/153048078
   wrote database to /tmp/153048078 

   1

   
   ...
   wrote mirroring manifests to manifests-redhat-operator-index-1614211642 

   2

   Copy to Clipboard Toggle word wrap

   1

   コマンドで生成された一時的な index.db データベースのディレクトリー。

   2

   生成される manifests ディレクトリー名を記録します。このディレクトリーは、後続の手順で参照されます。

   注記

   Red Hat Quay では、ネストされたリポジトリーはサポート対象外です。その結果、oc adm catalog mirror コマンドを実行すると、401 unauthorized エラーで失敗します。回避策として、oc adm catalog mirror コマンドを実行するときに --max-components = 2 オプションを使用して、ネストされたリポジトリーの作成を無効にすることができます。この回避策の詳細は Unauthorized error thrown while using catalog mirror command with Quay registry のナレッジソリューションを参照してください。

手順

1. ネットワークアクセスが無制限のワークステーションで以下のコマンドを実行し、コンテンツをローカルファイルにミラーリングします。

   $ oc adm catalog mirror \
       <index_image> \ 

   1

   
       file:///local/index \ 

   2

   
       -a ${REG_CREDS} \ 

   3

   
       --insecure \ 

   4

   
       --index-filter-by-os='<platform>/<arch>' 

   5

   Copy to Clipboard Toggle word wrap

   1

   ミラーリングするカタログのインデックスイメージを指定します。

   2

   現在のディレクトリーのローカルファイルにミラーリングするコンテンツを指定します。

   3

   オプション: 必要な場合は、レジストリー認証情報ファイルの場所を指定します。

   4

   オプション: ターゲットレジストリーの信頼を設定しない場合は、--insecure フラグを追加します。

   5

   オプション: 複数のバリアントが利用可能な場合に、選択するインデックスイメージのプラットフォームおよびアーキテクチャーを指定します。イメージは '<platform>/<arch>[/<variant>]' として指定されます。これはインデックスで参照されるイメージには適用されません。使用できる値は、linux/amd64、linux/ppc64le、linux/s390x、linux/arm64、および .* です。

   出力例

   ...
   info: Mirroring completed in 5.93s (5.915MB/s)
   wrote mirroring manifests to manifests-my-index-1614985528 

   1

   
   
   To upload local images to a registry, run:
   
   	oc adm catalog mirror file://local/index/myrepo/my-index:v1 REGISTRY/REPOSITORY 

   2

   Copy to Clipboard Toggle word wrap

   1

   生成される manifests ディレクトリー名を記録します。このディレクトリーは、後続の手順で参照されます。

   2

   提供されたインデックスイメージをベースとする、拡張された file:// パスを記録します。このパスは、後続のステップで参照されます。

   このコマンドにより、現在のディレクトリーに v2/ ディレクトリーが作成されます。

2. v2/ ディレクトリーをリムーバブルメディアにコピーします。
3. メディアを物理的に削除して、これをミラーレジストリーにアクセスできる非接続環境のホストに割り当てます。

4. ミラーレジストリーに認証が必要な場合は、非接続環境のホストで以下のコマンドを実行し、レジストリーにログインします。

   $ podman login <mirror_registry>

   Copy to Clipboard Toggle word wrap

5. v2/ ディレクトリーを含む親ディレクトリーから以下のコマンドを実行し、ローカルファイルからミラーレジストリーにイメージをアップロードします。

   $ oc adm catalog mirror \
       file://local/index/<repository>/<index_image>:<tag> \ 

   1

   
       <mirror_registry>:<port>[/<repository>] \ 

   2

   
       -a ${REG_CREDS} \ 

   3

   
       --insecure \ 

   4

   
       --index-filter-by-os='<platform>/<arch>' 

   5

   Copy to Clipboard Toggle word wrap

   1

   直前のコマンド出力の file:// パスを指定します。

   2

   Operator の内容をミラーリングするターゲットレジストリーの完全修飾ドメイン名 (FQDN) を指定します。ミラーレジストリー <repository> には、前提条件で説明した olm-mirror など、レジストリー上の既存のリポジトリーまたは namespace を指定できます。ミラーリング中に既存のリポジトリーが見つかった場合は、そのリポジトリー名が結果のイメージ名に追加されます。イメージ名にリポジトリー名を含めたくない場合は、この行から <repository> 値を省略します (例: <mirror_registry>:<port>)。

   3

   オプション: 必要な場合は、レジストリー認証情報ファイルの場所を指定します。

   4

   オプション: ターゲットレジストリーの信頼を設定しない場合は、--insecure フラグを追加します。

   5

   オプション: 複数のバリアントが利用可能な場合に、選択するインデックスイメージのプラットフォームおよびアーキテクチャーを指定します。イメージは '<platform>/<arch>[/<variant>]' として指定されます。これはインデックスで参照されるイメージには適用されません。使用できる値は、linux/amd64、linux/ppc64le、linux/s390x、linux/arm64、および .* です。

   注記

   Red Hat Quay では、ネストされたリポジトリーはサポート対象外です。その結果、oc adm catalog mirror コマンドを実行すると、401 unauthorized エラーで失敗します。回避策として、oc adm catalog mirror コマンドを実行するときに --max-components = 2 オプションを使用して、ネストされたリポジトリーの作成を無効にすることができます。この回避策の詳細は Unauthorized error thrown while using catalog mirror command with Quay registry のナレッジソリューションを参照してください。

6. oc adm catalog mirror コマンドを再度実行します。新しくミラー化されたインデックスイメージをソースとして使用し、前の手順で使用したものと同じミラーレジストリーターゲットを使用します。

   $ oc adm catalog mirror \
       <mirror_registry>:<port>/<index_image> \
       <mirror_registry>:<port>[/<repository>] \
       --manifests-only \

   1

   
       [-a ${REG_CREDS}] \
       [--insecure]

   Copy to Clipboard Toggle word wrap

   1

   コマンドがミラーリングされたすべてのコンテンツを再度コピーしないように、このステップには --manifests-only フラグが必要です。

   重要

   前のステップで生成された imageContentSourcePolicy.yaml ファイルのイメージマッピングをローカルパスから有効なミラー位置に更新する必要があるため、このステップが必要です。そうしないと、後のステップで ImageContentSourcePolicy オブジェクトを作成するときにエラーが発生します。