14.3. エージェントベースのインストーラーを使用した OpenShift Container Platform クラスターのインストール

1. ログイン認証情報を使用して OpenShift Container Platform Web コンソールにログインします。
2. データセンター に移動します。
3. Run Agent-based Installer locally をクリックします。
4. OpenShift インストーラー と コマンドラインインターフェイス のオペレーティングシステムとアーキテクチャーを選択します。
5. Download Installer をクリックして、インストールプログラムをダウンロードして展開します。
6. Download pull secret または Copy pull secret をクリックして、プルシークレットをダウンロードまたはコピーできます。
7. Download command-line tools をクリックし、openshift-install バイナリーを PATH 上のディレクトリーに配置します。

手順

1. 以下のコマンドを実行して nmstate の依存関係をインストールします。

   $ sudo dnf install /usr/bin/nmstatectl -y

2. PATH にあるディレクトリーに openshift-install バイナリーを配置します。

3. 次のコマンドを実行して、インストール設定を保存するディレクトリーを作成します。

   $ mkdir ~/<directory_name>

   注記

   これは、エージェントベースのインストールで推奨される方法です。GitOps ZTP マニフェストの使用はオプションです。

4. install-config.yaml ファイルを作成します。

   cat << EOF > ./my-cluster/install-config.yaml
   apiVersion: v1
   baseDomain: test.example.com
   compute:
   - architecture: amd64 1
     hyperthreading: Enabled
     name: worker
     replicas: 0
   controlPlane:
     architecture: amd64
     hyperthreading: Enabled
     name: master
     replicas: 1
   metadata:
     name: sno-cluster 2
   networking:
     clusterNetwork:
     - cidr: 10.128.0.0/14
       hostPrefix: 23
     machineNetwork:
     - cidr: 192.168.111.0/16
     networkType: OVNKubernetes 3
     serviceNetwork:
     - 172.30.0.0/16
   platform:
     none: {}
   pullSecret: '<pull_secret>' 4
   sshKey: |
     '<ssh_pub_key>' 5
     EOF

   1

   システムアーキテクチャーを指定します。有効な値は amd64 と arm64 です。

   2

   必須。クラスター名を指定します。

   3

   インストールするクラスターネットワークプラグインを指定します。サポートされている値は OVNKubernetes と OpenShiftSDN です。デフォルトの値は OVNkubernetes です。

   4

   プルシークレットを指定します。

   5

   ssh 公開鍵を指定します。

   注記

   プラットフォームを vSphere または baremetal に設定すると、クラスターノードの IP アドレスエンドポイントを次の 3 つの方法で設定できます。

   • IPv4
   • IPv6
   • IPv4 と IPv6 の並列 (デュアルスタック)

   IPv6 は、ベアメタルプラットフォームでのみサポートされます。

   デュアルスタックネットワーキングの例

   networking:
     clusterNetwork:
       - cidr: 172.21.0.0/16
         hostPrefix: 23
       - cidr: fd02::/48
         hostPrefix: 64
     machineNetwork:
       - cidr: 192.168.11.0/16
       - cidr: 2001:DB8::/32
     serviceNetwork:
       - 172.22.0.0/16
       - fd03::/112
     networkType: OVNKubernetes
   platform:
     baremetal:
       apiVIPs:
       - 192.168.11.3
       - 2001:DB8::4
       ingressVIPs:
       - 192.168.11.4
       - 2001:DB8::5

5. agent-config.yaml ファイルを作成します。

     cat > agent-config.yaml << EOF
     apiVersion: v1alpha1
     kind: AgentConfig
     metadata:
       name: sno-cluster
     rendezvousIP: 192.168.111.80 1
     hosts: 2
       - hostname: master-0 3
         interfaces:
           - name: eno1
             macAddress: 00:ef:44:21:e6:a5
         rootDeviceHints: 4
           deviceName: /dev/sdb
         networkConfig: 5
           interfaces:
             - name: eno1
               type: ethernet
               state: up
               mac-address: 00:ef:44:21:e6:a5
               ipv4:
                 enabled: true
                 address:
                   - ip: 192.168.111.80
                     prefix-length: 23
                 dhcp: false
           dns-resolver:
             config:
               server:
                 - 192.168.111.1
           routes:
             config:
               - destination: 0.0.0.0/0
                 next-hop-address: 192.168.111.2
                 next-hop-interface: eno1
                 table-id: 254
     EOF

   1

   この IP アドレスは、ブートストラッププロセスを実行するノードや、assisted-service コンポーネントを実行するノードを判別するために使用されます。networkConfig パラメーターで少なくとも 1 つのホストの IP アドレスを指定しない場合は、ランデブー IP アドレスを指定する必要があります。このアドレスが指定されていない場合、指定されたホストの networkConfig から 1 つの IP アドレスが選択されます。

   2

   ホスト設定はオプションです。定義されたホストの数は、install-config.yaml ファイルで定義されたホストの総数 (compute.replicas および controlPlane.replicas パラメーターの値の合計) を超えてはなりません。

   3

   オプションの hostname パラメーターは、動的ホスト設定プロトコル (DHCP) または逆引き DNS ルックアップから取得したホスト名をオーバーライドします。各ホストには、これらの方法のいずれかによって提供される一意のホスト名が必要です。

   4

   rootDeviceHints パラメーターは、Red Hat Enterprise Linux CoreOS (RHCOS) イメージを特定のデバイスにプロビジョニングできるようにします。これは、検出順にデバイスを検査し、検出された値をヒントの値と比較します。ヒントの値と一致する最初に検出されたデバイスが使用されます。

   5

   ホストのネットワークインターフェイスを NMState 形式で設定するには、このオプションパラメーターを設定します。

6. 以下のコマンドを実行して agent イメージを作成します。

   $ openshift-install --dir <install_directory> agent create image

   注記

   Red Hat Enterprise Linux CoreOS (RHCOS) はプライマリーディスクでのマルチパスをサポートするようになり、ハードウェア障害に対する対障害性が強化され、ホストの可用性を強化できるようになりました。マルチパス化は、デフォルトの /etc/multipath.conf 設定を使用して、agent.iSO イメージでデフォルトで有効になっています。

7. ベアメタルマシンで agent.x86_64.iso または agent.aarch64.iso イメージを起動します。

手順

1. エージェントコンソールアプリケーションが、設定されたリリースイメージをレジストリーからプルできるかどうかを確認するまで待ちます。

2. エージェントコンソールアプリケーションが、インストーラーの接続チェックに合格したことを示している場合は、プロンプトがタイムアウトになるまで待って、インストールを続行します。

   注記

   接続チェックに合格した場合も、ネットワーク設定の表示または変更を選択できます。

   ただし、タイムアウトせずに、エージェントコンソールアプリケーションとやりとりすることを選択した場合は、TUI を手動で終了して、インストールを続行する必要があります。

3. エージェントコンソールアプリケーションのチェックが失敗した場合は、Release image URL プルチェックの横に赤いアイコンが表示されます。ホストのネットワーク設定を再設定するには、次の手順を使用します。

   1. TUI の Check Errors セクションを読みます。このセクションには、失敗したチェックに固有のエラーメッセージが表示されます。

      
   2. Configure network を選択して、NetworkManager TUI を起動します。
   3. Edit a connection を選択し、再設定する接続を選択します。
   4. 設定を編集し、OK を選択して、変更を保存します。
   5. Back を選択して、NetworkManager TUI のメイン画面に戻ります。
   6. Activate a Connection を選択します。
   7. 再設定されたネットワークを選択して、非アクティブ化します。
   8. 再設定されたネットワークを再度選択して、再アクティブ化します。
   9. Back を選択し、Quit を選択して、エージェントコンソールアプリケーションに戻ります。
   10. 新しいネットワーク設定を使用して、継続的なネットワークチェックが再開されるまで、5 秒間以上、待ちます。
   11. Release image URL プルチェックが成功し、URL の横に緑色のアイコンが表示された場合は、Quit を選択して、エージェントコンソールアプリケーションを終了し、インストールを続行します。

手順

1. オプション: ブートストラップホスト (ランデブーホスト) がいつ再起動するかを知るには、次のコマンドを実行します。

   $ ./openshift-install --dir <install_directory> agent wait-for bootstrap-complete \ 1
       --log-level=info 2

   1

   <install_directory> には、エージェント ISO が生成されたディレクトリーへのパスを指定します。

   2

   異なるインストールの詳細情報を表示するには、info ではなく、warn、debug、または error を指定します。

   出力例

   ...................................................................
   ...................................................................
   INFO Bootstrap configMap status is complete
   INFO cluster bootstrap is complete

   Kubernetes API サーバーでこれがコントロールプレーンマシンにブートストラップされていることを示すシグナルが出されるとコマンドは成功します。

2. 進行状況を追跡し、インストールが成功したことを確認するには、次のコマンドを実行します。

   $ openshift-install --dir <install_directory> agent wait-for install-complete 1

   1

   <install_directory> directory には、エージェント ISO が生成されたディレクトリーへのパスを指定します。

   出力例

   ...................................................................
   ...................................................................
   INFO Cluster is installed
   INFO Install complete!
   INFO To access the cluster as the system:admin user when using 'oc', run
   INFO     export KUBECONFIG=/home/core/installer/auth/kubeconfig
   INFO Access the OpenShift web-console here: https://console-openshift-console.apps.sno-cluster.test.example.com