12.4. OpenShift Container Platform 用の PXE アセットの準備

手順

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.0.0/16
     networkType: OVNKubernetes 3
     serviceNetwork:
     - 172.30.0.0/16
   platform: 4
     none: {}
   pullSecret: '<pull_secret>' 5
   sshKey: '<ssh_pub_key>' 6
   EOF

   1

   システムアーキテクチャーを指定します。有効な値は、amd64、arm64、ppc64le、および s390x です。

   2

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

   3

   インストールするクラスターネットワークプラグイン。サポートされる値はデフォルト値の OVNKubernetes のみです。

   4

   プラットフォームを指定します。

   注記

   ベアメタルプラットフォームの場合、agent-config.yaml ファイル上での設定でオーバーライドされない限り、install-config.yaml ファイルのプラットフォームセクションでのホスト設定がデフォルトで使用されます。

   5

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

   6

   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

   注記

   非接続ミラーレジストリーを使用する場合は、作成済みのミラーレジストリー用の証明書ファイルを install-config.yaml ファイルの additionalTrustBundle フィールドに追加する必要があります。

5. 次のコマンドを実行して、agent-config.yaml ファイルを作成します。

   $ cat > agent-config.yaml << EOF
   apiVersion: v1beta1
   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

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

   4

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

   5

   オプション: ホストのネットワークインターフェイスを NMState 形式で設定します。

6. オプション: iPXE スクリプトを作成するには、bootArtifactsBaseURL を agent-config.yaml ファイルに追加します。

   apiVersion: v1beta1
   kind: AgentConfig
   metadata:
     name: sno-cluster
   rendezvousIP: 192.168.111.80
   bootArtifactsBaseURL: <asset_server_URL>

   <asset_server_URL> は、PXE アセットをアップロードするサーバーの URL です。

手順

1. 次のコマンドを実行して、PXE アセットを作成します。

   $ openshift-install agent create pxe-files

   生成された PXE アセットと任意の iPXE スクリプトは、boot-artifacts ディレクトリーにあります。

   PXE アセットとオプションの iPXE スクリプトを含むファイルシステムの例

   boot-artifacts
       ├─ agent.x86_64-initrd.img
       ├─ agent.x86_64.ipxe
       ├─ agent.x86_64-rootfs.img
       └─ agent.x86_64-vmlinuz

   重要

   boot-artifacts ディレクトリーの内容は、指定したアーキテクチャーによって異なります。

   注記

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

2. PXE アセットと任意のスクリプトをインフラストラクチャーにアップロードし、ブートプロセス中にアクセスできるようにします。

   注記

   iPXE スクリプトを生成した場合、アセットの場所は、agent-config.yaml ファイルに追加した bootArtifactsBaseURL と一致する必要があります。