5.4. OpenShift Container Platform イメージリポジトリーのミラーリング

手順

1. OpenShift Container Platform のアップグレードパス を確認し、現在のクラスターバージョンと意図されるクラスターバージョン間にアップグレードパスがあることを確認します。

2. 必要な環境変数を設定します。

   $ OCP_RELEASE=<release_version> 

   1

   
   $ LOCAL_REGISTRY='<local_registry_host_name>:<local_registry_host_port>' 

   2

   
   $ LOCAL_REPOSITORY='<local_repository_name>' 

   3

   
   $ PRODUCT_REPO='openshift-release-dev' 

   4

   
   $ LOCAL_SECRET_JSON='<path_to_pull_secret>' 

   5

   
   $ RELEASE_NAME='ocp-release' 

   6

   
   $ ARCHITECTURE=<server_architecture> 

   7

   
   $ REMOVABLE_MEDIA_PATH=<path> 

   8

   1

   <release_version> について、インストールする OpenShift Container Platform のバージョンに対応するタグを指定します (例: 4.5.0)。

   2

   <local_registry_host_name> については、ミラーレジストリーのレジストリードメイン名を指定し、<local_registry_host_port> については、コンテンツの送信に使用するポートを指定します。

   3

   <repository_name> については、ocp4/openshift4 などのレジストリーに作成するリポジトリーの名前を指定します。

   4

   ミラーリングするリポジトリー。実稼働環境のリリースの場合には、openshift-release-dev を指定する必要があります。

   5

   <path_to_pull_secret> については、作成したミラーレジストリーのプルシークレットおよびファイル名の絶対パスを指定します。

   6

   実稼働環境のリリースについては、ocp-release を指定する必要があります。

   7

   <server_architecture> について、サーバーのアーキテクチャー (x86_64 など) を指定します。

   8

   <path> については、最初のスラッシュ (/) 文字を含む完全パスを指定します。

3. ミラーリングするイメージおよび設定マニフェストを確認します。

   $ oc adm release mirror -a ${LOCAL_SECRET_JSON} --to-dir=${REMOVABLE_MEDIA_PATH}/mirror quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE} --dry-run

4. バージョンイメージを内部コンテナーレジストリーにミラーリングします。

   • ミラーホストがインターネットにアクセスできない場合は、以下の操作を実行します。

     1. リムーバブルメディアをインターネットに接続しているシステムに接続します。

     2. イメージおよび設定マニフェストをリムーバブルメディア上のディレクトリーにミラーリングします。

        $ oc adm release mirror -a ${LOCAL_SECRET_JSON} --to-dir=${REMOVABLE_MEDIA_PATH}/mirror quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE}

     3. メディアをネットワークが制限された環境に移し、イメージをローカルコンテナーレジストリーにアップロードします。

        $ oc image mirror  -a ${LOCAL_SECRET_JSON} --from-dir=${REMOVABLE_MEDIA_PATH}/mirror "file://openshift/release:${OCP_RELEASE}*" ${LOCAL_REGISTRY}/${LOCAL_REPOSITORY} 

        1

        1

        REMOVABLE_MEDIA_PATH の場合、イメージのミラーリング時に指定した同じパスを使用する必要があります。

   • ローカルコンテナーレジストリーとクラスターがミラーホストに接続されている場合、リリースイメージをローカルレジストリーに直接プッシュし、以下のコマンドを使用して設定マップをクラスターに適用します。

     $ oc adm release mirror -a ${LOCAL_SECRET_JSON} --from=quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE} \
       --to=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY} --apply-release-image-signature

     注記

     --apply-release-image-signature オプションが含まれる場合は、イメージ署名の検証用に設定マップを作成しません。