12.2. 切断されたインストールのミラーリングについて
切断されたインストールにミラーレジストリーを使用して、クラスターが外部コンテンツに対する組織の制御を満たすコンテナーイメージのみを使用するようにすることができます。ネットワークが切断された環境でプロビジョニングするインフラストラクチャーにクラスターをインストールする前に、必要なコンテナーイメージをその環境にミラーリングする必要があります。コンテナーイメージをミラーリングするには、ミラーリング用のレジストリーが必要です。
12.2.1. Agent-based Installer による非接続インストールのイメージのミラーリング
以下の手順のいずれかを使用して、OpenShift Container Platform イメージリポジトリーをミラーレジストリーにミラーリングできます。
12.2.2. 切断されたレジストリーの OpenShift Container Platform イメージリポジトリーのミラーリング
Agent-based Installer による非接続インストールにミラーイメージを使用するには、install-config.yaml
ファイルを変更する必要があります。
oc adm release mirror
または oc mirror
コマンドの出力を使用して、リリースイメージをミラーリングできます。これは、ミラーレジストリーの設定に使用したコマンドによって異なります。
次の例は、oc adm release mirror
コマンドの出力を示しています。
$ oc adm release mirror
出力例
To use the new mirrored repository to install, add the following section to the install-config.yaml: imageContentSources: mirrors: virthost.ostest.test.metalkube.org:5000/localimages/local-release-image source: quay.io/openshift-release-dev/ocp-v4.0-art-dev mirrors: virthost.ostest.test.metalkube.org:5000/localimages/local-release-image source: registry.ci.openshift.org/ocp/release
次の例は、oc-mirror プラグインによって生成された imageContentSourcePolicy.yaml
ファイルの一部を示しています。このファイルは結果ディレクトリーにあります (例: oc-mirror-workspace/results-1682697932/
)。
imageContentSourcePolicy.yaml
ファイルの例
spec: repositoryDigestMirrors: - mirrors: - virthost.ostest.test.metalkube.org:5000/openshift/release source: quay.io/openshift-release-dev/ocp-v4.0-art-dev - mirrors: - virthost.ostest.test.metalkube.org:5000/openshift/release-images source: quay.io/openshift-release-dev/ocp-release
12.2.2.1. ミラーリングされたイメージを使用するように Agent-based Installer を設定する
ミラーリングされたイメージを使用するように Agent-based Installer を設定するには、oc adm release mirror
コマンドまたは oc-mirror プラグインの出力を使用する必要があります。
手順
oc-mirror プラグインを使用してリリースイメージをミラーリングした場合:
-
結果ディレクトリーにある
imageContentSourcePolicy.yaml
を開きます (例:oc-mirror-workspace/results-1682697932/
)。 -
yaml ファイルの
repositoryDigestMirrors
セクションのテキストをコピーします。
-
結果ディレクトリーにある
oc adm release mirror
コマンドを使用してリリースイメージをミラーリングした場合:-
コマンド出力の
imageContentSources
セクションのテキストをコピーします。
-
コマンド出力の
-
コピーしたテキストを
install-config.yaml
ファイルのimageContentSources
フィールドに貼り付けます。 ミラーレジストリーに使用される証明書ファイルを yaml ファイルの
additionalTrustBundle
フィールドに追加します。重要この値は、ミラーレジストリーに使用した証明書ファイルの内容である必要があります。証明書ファイルは、既存の信頼できる認証局、またはミラーレジストリー用に生成した自己署名証明書のいずれかです。
install-config.yaml
ファイルの例additionalTrustBundle: | -----BEGIN CERTIFICATE----- ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ -----END CERTIFICATE-----
GitOps ZTP マニフェストを使用している場合:
registries.conf
およびca-bundle.crt
ファイルをmirror
パスに追加して、エージェント ISO イメージにミラー設定を追加します。注記oc adm release mirror
コマンドまたはoc mirror
プラグインの出力からregistries.conf
ファイルを作成できます。/etc/containers/registries.conf
ファイルの形式が変更されました。現在のバージョンはバージョン 2 で、TOML 形式です。registries.conf
ファイルの例[[registry]] location = "registry.ci.openshift.org/ocp/release" mirror-by-digest-only = true [[registry.mirror]] location = "virthost.ostest.test.metalkube.org:5000/localimages/local-release-image" [[registry]] location = "quay.io/openshift-release-dev/ocp-v4.0-art-dev" mirror-by-digest-only = true [[registry.mirror]] location = "virthost.ostest.test.metalkube.org:5000/localimages/local-release-image"