7.5. ミラーホストの準備

手順

1. oc-mirror CLI プラグインをダウンロードします。

   1. Red Hat Hybrid Cloud Console の Downloads ページに移動します。
   2. OpenShift disconnected installation tools セクションで、ドロップダウンメニューから OpenShift Client (oc) mirror plugin の OS type と Architecture type を選択します。
   3. Download をクリックしてファイルを保存します。

2. 次のコマンドを実行してアーカイブを展開します。

   $ tar xvzf oc-mirror.tar.gz

   Copy to Clipboard Toggle word wrap

3. 必要に応じて、次のコマンドを実行し、プラグインファイルを更新して実行可能にします。

   $ chmod +x oc-mirror

   Copy to Clipboard Toggle word wrap
   注記

   oc-mirror ファイルの名前を変更しないでください。

4. 次のコマンドを実行して、PATH (例: /usr/local/bin) にファイルを配置し、oc-mirror CLI プラグインをインストールします。

   $ sudo mv oc-mirror /usr/local/bin/.

   Copy to Clipboard Toggle word wrap

1. registry.redhat.io プルシークレットを Red Hat OpenShift Cluster Manager からダウンロードします。

2. 次のコマンドを実行して、プルシークレットのコピーを JSON 形式で作成します。

   $ cat ./pull-secret | jq . > <path>/<pull_secret_file_in_json> 

   1

   Copy to Clipboard Toggle word wrap

   1

   プルシークレットを保存するフォルダーへのパスおよび作成する JSON ファイルの名前を指定します。

   プルシークレットの例

   {
     "auths": {
       "cloud.openshift.com": {
         "auth": "b3BlbnNo...",
         "email": "you@example.com"
       },
       "quay.io": {
         "auth": "b3BlbnNo...",
         "email": "you@example.com"
       },
       "registry.connect.redhat.com": {
         "auth": "NTE3Njg5Nj...",
         "email": "you@example.com"
       },
       "registry.redhat.io": {
         "auth": "NTE3Njg5Nj...",
         "email": "you@example.com"
       }
     }
   }

   Copy to Clipboard Toggle word wrap

3. ファイルを、~/.docker/config.json または $XDG_RUNTIME_DIR/containers/auth.json として保存します。

   1. .docker または $XDG_RUNTIME_DIR/containers ディレクトリーが存在しない場合は、次のコマンドを入力して作成します。

      $ mkdir -p <directory_name>

      Copy to Clipboard Toggle word wrap

      この場合の <directory_name> は、~/.docker または $XDG_RUNTIME_DIR/containers のいずれかです。

   2. 次のコマンドを入力して、プルシークレットを適切なディレクトリーにコピーします。

      $ cp <path>/<pull_secret_file_in_json> <directory_name>/<auth_file>

      Copy to Clipboard Toggle word wrap

      この場合の <directory_name> は ~/.docker または $XDG_RUNTIME_DIR/containers、<auth_file> は config.json または auth.json のいずれかです。

4. 次のコマンドを実行して、ミラーレジストリーの base64 でエンコードされたユーザー名とパスワードまたはトークンを生成します。

   $ echo -n '<user_name>:<password>' | base64 -w0 

   1

   Copy to Clipboard Toggle word wrap

   1

   <user_name> および <password> には、レジストリーに設定したユーザー名およびパスワードを指定します。

   出力例

   BGVtbYk3ZHAtqXs=

   Copy to Clipboard Toggle word wrap

5. JSON ファイルを編集し、レジストリーを記述するセクションをこれに追加します。

     "auths": {
       "<mirror_registry>": { 

   1

   
         "auth": "<credentials>", 

   2

   
         "email": "you@example.com"
       }
     },

   Copy to Clipboard Toggle word wrap

   1

   ミラーレジストリーがコンテンツを提供するために使用するレジストリーのドメイン名およびポート (オプション) を指定します。例: registry.example.com または registry.example.com:8443

   2

   ミラーレジストリーの base64 でエンコードされたユーザー名およびパスワードを指定します。

   変更済みのプルシークレットの例

   {
     "auths": {
       "registry.example.com": {
         "auth": "BGVtbYk3ZHAtqXs=",
         "email": "you@example.com"
       },
       "cloud.openshift.com": {
         "auth": "b3BlbnNo...",
         "email": "you@example.com"
       },
       "quay.io": {
         "auth": "b3BlbnNo...",
         "email": "you@example.com"
       },
       "registry.connect.redhat.com": {
         "auth": "NTE3Njg5Nj...",
         "email": "you@example.com"
       },
       "registry.redhat.io": {
         "auth": "NTE3Njg5Nj...",
         "email": "you@example.com"
       }
     }
   }

   Copy to Clipboard Toggle word wrap