installer-provisioned クラスターのベアメタルへのデプロイ

1. 1 つの CPU は、同時マルチスレッド (SMT) またはハイパースレッディングが有効にされていない場合に 1 つの物理コアと同等です。これが有効にされている場合、以下の数式を使用して対応する比率を計算します: (コアごとのスレッド × コア数) × ソケット数 = CPU
2. OpenShift Container Platform と Kubernetes は、ディスクのパフォーマンスの影響を受けるため、特にコントロールプレーンノードの etcd には、より高速なストレージが推奨されます。多くのクラウドプラットフォームでは、ストレージサイズと IOPS スケールが一緒にあるため、十分なパフォーマンスを得るためにストレージボリュームの割り当てが必要になる場合があります。

手順

1. ノードを起動し、BIOS メニューを入力します。
2. ノードのブートモードを UEFI Enabled に設定します。
3. Secure Boot を有効にします。

手順

1. ssh でプロビジョナーノードにログインします。

2. root 以外のユーザー (kni) を作成し、そのユーザーに sudo 権限を付与します。

   # useradd kni

   Copy to Clipboard Toggle word wrap

   # passwd kni

   Copy to Clipboard Toggle word wrap

   # echo "kni ALL=(root) NOPASSWD:ALL" | tee -a /etc/sudoers.d/kni

   Copy to Clipboard Toggle word wrap

   # chmod 0440 /etc/sudoers.d/kni

   Copy to Clipboard Toggle word wrap

3. 新規ユーザーの ssh キーを作成します。

   # su - kni -c "ssh-keygen -t ed25519 -f /home/kni/.ssh/id_rsa -N ''"

   Copy to Clipboard Toggle word wrap

4. プロビジョナーノードで新規ユーザーとしてログインします。

   # su - kni

   Copy to Clipboard Toggle word wrap

5. Red Hat Subscription Manager を使用してプロビジョナーノードを登録します。

   $ sudo subscription-manager register --username=<user> --password=<pass> --auto-attach

   Copy to Clipboard Toggle word wrap

   $ sudo subscription-manager repos --enable=rhel-9-for-<architecture>-appstream-rpms --enable=rhel-9-for-<architecture>-baseos-rpms

   Copy to Clipboard Toggle word wrap
   注記

   Red Hat Subscription Manager の詳細は、Using and Configuring Red Hat Subscription Manager を参照してください。

6. 以下のパッケージをインストールします。

   $ sudo dnf install -y libvirt qemu-kvm mkisofs python3-devel jq ipmitool

   Copy to Clipboard Toggle word wrap

7. ユーザーを変更して、新たに作成したユーザーに libvirt グループを追加します。

   $ sudo usermod --append --groups libvirt <user>

   Copy to Clipboard Toggle word wrap

8. firewalld を再起動して、http サービスを有効にします。

   $ sudo systemctl start firewalld

   Copy to Clipboard Toggle word wrap

   $ sudo firewall-cmd --zone=public --add-service=http --permanent

   Copy to Clipboard Toggle word wrap

   $ sudo firewall-cmd --reload

   Copy to Clipboard Toggle word wrap

9. libvirtd サービスを開始して、これを有効にします。

   $ sudo systemctl enable libvirtd --now

   Copy to Clipboard Toggle word wrap

10. default ストレージプールを作成して、これを起動します。

    $ sudo virsh pool-define-as --name default --type dir --target /var/lib/libvirt/images

    Copy to Clipboard Toggle word wrap

    $ sudo virsh pool-start default

    Copy to Clipboard Toggle word wrap

    $ sudo virsh pool-autostart default

    Copy to Clipboard Toggle word wrap

11. pull-secret.txt ファイルを作成します。

    $ vim pull-secret.txt

    Copy to Clipboard Toggle word wrap

    Web ブラウザーで、Install OpenShift on Bare Metal with installer-provisioned infrastructure に移動します。Copy pull secret をクリックします。pull-secret.txt ファイルにコンテンツを貼り付け、そのコンテンツを kni ユーザーのホームディレクトリーに保存します。

手順

1. ssh コマンドを使用してノードにログインします。

2. 次のコマンドを実行して、ノードで利用可能な NTP サーバーを表示します。

   $ chronyc sources

   Copy to Clipboard Toggle word wrap

   出力例

   MS Name/IP address         Stratum Poll Reach LastRx Last sample
   ===============================================================================
   ^+ time.cloudflare.com           3  10   377   187   -209us[ -209us] +/-   32ms
   ^+ t1.time.ir2.yahoo.com         2  10   377   185  -4382us[-4382us] +/-   23ms
   ^+ time.cloudflare.com           3  10   377   198   -996us[-1220us] +/-   33ms
   ^* brenbox.westnet.ie            1  10   377   193  -9538us[-9761us] +/-   24ms

   Copy to Clipboard Toggle word wrap

3. ping コマンドを使用して、ノードが NTP サーバーにアクセスできることを確認します。次に例を示します。

   $ ping time.cloudflare.com

   Copy to Clipboard Toggle word wrap

   出力例

   PING time.cloudflare.com (162.159.200.123) 56(84) bytes of data.
   64 bytes from time.cloudflare.com (162.159.200.123): icmp_seq=1 ttl=54 time=32.3 ms
   64 bytes from time.cloudflare.com (162.159.200.123): icmp_seq=2 ttl=54 time=30.9 ms
   64 bytes from time.cloudflare.com (162.159.200.123): icmp_seq=3 ttl=54 time=36.7 ms
   ...

   Copy to Clipboard Toggle word wrap

手順

1. 次のコマンドを実行して、ベアメタルネットワーク NIC 名をエクスポートします。

   $ export PUB_CONN=<baremetal_nic_name>

   Copy to Clipboard Toggle word wrap

2. ベアメタルネットワークを設定します。

   注記

   これらの手順を実行した後、SSH 接続が切断される場合があります。

   1. DHCP を使用するネットワークの場合は、次のコマンドを実行します。

      $ sudo nohup bash -c "
          nmcli con down \"$PUB_CONN\"
          nmcli con delete \"$PUB_CONN\"
          # RHEL 8.1 appends the word \"System\" in front of the connection, delete in case it exists
          nmcli con down \"System $PUB_CONN\"
          nmcli con delete \"System $PUB_CONN\"
          nmcli connection add ifname baremetal type bridge <con_name> baremetal bridge.stp no 

      1

      
          nmcli con add type bridge-slave ifname \"$PUB_CONN\" master baremetal
          pkill dhclient;dhclient baremetal
      "

      Copy to Clipboard Toggle word wrap

      1

      <con_name> を接続名に置き換えます。

   2. 静的 IP アドレスを使用し、DHCP ネットワークを使用しないネットワークの場合は、次のコマンドを実行します。

      $ sudo nohup bash -c "
          nmcli con down \"$PUB_CONN\"
          nmcli con delete \"$PUB_CONN\"
          # RHEL 8.1 appends the word \"System\" in front of the connection, delete in case it exists
          nmcli con down \"System $PUB_CONN\"
          nmcli con delete \"System $PUB_CONN\"
          nmcli connection add ifname baremetal type bridge con-name baremetal bridge.stp no ipv4.method manual ipv4.addr "x.x.x.x/yy" ipv4.gateway "a.a.a.a" ipv4.dns "b.b.b.b" 

      1

      
          nmcli con add type bridge-slave ifname \"$PUB_CONN\" master baremetal
          nmcli con up baremetal
      "

      Copy to Clipboard Toggle word wrap

      1

      <con_name> を接続名に置き換えます。x.x.x.x/yy をネットワークの IP アドレスと CIDR に置き換えます。a.a.a.a をネットワークゲートウェイに置き換えます。b.b.b.b を DNS サーバーの IP アドレスに置き換えます。

3. オプション: プロビジョニングネットワークを使用してデプロイする場合は、次のコマンドを実行してプロビジョニングネットワークの NIC 名をエクスポートします。

   $ export PROV_CONN=<prov_nic_name>

   Copy to Clipboard Toggle word wrap

4. オプション: プロビジョニングネットワークを使用してデプロイする場合は、次のコマンドを実行してプロビジョニングネットワークを設定します。

   $ sudo nohup bash -c "
       nmcli con down \"$PROV_CONN\"
       nmcli con delete \"$PROV_CONN\"
       nmcli connection add ifname provisioning type bridge con-name provisioning
       nmcli con add type bridge-slave ifname \"$PROV_CONN\" master provisioning
       nmcli connection modify provisioning ipv6.addresses fd00:1101::1/64 ipv6.method manual
       nmcli con down provisioning
       nmcli con up provisioning
   "

   Copy to Clipboard Toggle word wrap
   注記

   これらの手順を実行した後、SSH 接続が切断される場合があります。

   IPv6 アドレスは、ベアメタルネットワーク経由でルーティングできない任意のアドレスにすることができます。

   IPv6 アドレスを使用する場合に UEFI PXE 設定が有効にされており、UEFI PXE 設定が IPv6 プロトコルに設定されていることを確認します。

5. オプション: プロビジョニングネットワークを使用してデプロイする場合は、次のコマンドを実行して、プロビジョニングネットワーク接続で IPv4 アドレスを設定します。

   $ nmcli connection modify provisioning ipv4.addresses 172.22.0.254/24 ipv4.method manual

   Copy to Clipboard Toggle word wrap

6. 次のコマンドを実行して、provisioner ノードに SSH で戻ります (必要な場合)。

   # ssh kni@provisioner.<cluster-name>.<domain>

   Copy to Clipboard Toggle word wrap

7. 次のコマンドを実行して、接続ブリッジが適切に作成されたことを確認します。

   $ sudo nmcli con show

   Copy to Clipboard Toggle word wrap

   出力例

   NAME               UUID                                  TYPE      DEVICE
   baremetal          4d5133a5-8351-4bb9-bfd4-3af264801530  bridge    baremetal
   provisioning       43942805-017f-4d7d-a2c2-7cb3324482ed  bridge    provisioning
   virbr0             d9bca40f-eee1-410b-8879-a2d4bb0465e7  bridge    virbr0
   bridge-slave-eno1  76a8ed50-c7e5-4999-b4f6-6d9014dd0812  ethernet  eno1
   bridge-slave-eno2  f31c3353-54b7-48de-893a-02d2b34c4736  ethernet  eno2

   Copy to Clipboard Toggle word wrap

手順

1. 1 番目のサブネットが 2 番目のサブネットと通信するように設定します。

   1. 次のコマンドを実行して、コントロールプレーンノードに root としてログインします。

      $ sudo su -

      Copy to Clipboard Toggle word wrap

   2. 次のコマンドを実行して、ネットワークインターフェイスの名前を取得します。

      # nmcli dev status

      Copy to Clipboard Toggle word wrap

   3. 次のコマンドを実行して、ゲートウェイを経由する 2 番目のサブネット (192.168.0.0) へのルートを追加します。

      # nmcli connection modify <interface_name> +ipv4.routes "192.168.0.0/24 via <gateway>"

      Copy to Clipboard Toggle word wrap

      <interface_name> をインターフェイス名に置き換えます。<gateway> を実際のゲートウェイの IP アドレスに置き換えます。

      例

      # nmcli connection modify eth0 +ipv4.routes "192.168.0.0/24 via 192.168.0.1"

      Copy to Clipboard Toggle word wrap

   4. 次のコマンドを実行して変更を適用します。

      # nmcli connection up <interface_name>

      Copy to Clipboard Toggle word wrap

      <interface_name> をインターフェイス名に置き換えます。

   5. ルーティングテーブルを検証して、ルートが正常に追加されたことを確認します。

      # ip route

      Copy to Clipboard Toggle word wrap

   6. 1 番目のサブネットの各コントロールプレーンノードに対して前の手順を繰り返します。

      注記

      コマンドは、実際のインターフェイス名とゲートウェイに合わせて調整してください。

2. 1 番目のサブネットと通信するように 2 番目のサブネットを設定します。

   1. 次のコマンドを実行して、リモートワーカーノードに root としてログインします。

      $ sudo su -

      Copy to Clipboard Toggle word wrap

   2. 次のコマンドを実行して、ネットワークインターフェイスの名前を取得します。

      # nmcli dev status

      Copy to Clipboard Toggle word wrap

   3. 次のコマンドを実行して、ゲートウェイを経由する最初のサブネット (10.0.0.0) へのルートを追加します。

      # nmcli connection modify <interface_name> +ipv4.routes "10.0.0.0/24 via <gateway>"

      Copy to Clipboard Toggle word wrap

      <interface_name> をインターフェイス名に置き換えます。<gateway> を実際のゲートウェイの IP アドレスに置き換えます。

      例

      # nmcli connection modify eth0 +ipv4.routes "10.0.0.0/24 via 10.0.0.1"

      Copy to Clipboard Toggle word wrap

   4. 次のコマンドを実行して変更を適用します。

      # nmcli connection up <interface_name>

      Copy to Clipboard Toggle word wrap

      <interface_name> をインターフェイス名に置き換えます。

   5. 次のコマンドを実行して、ルーティングテーブルを検証し、ルートが正常に追加されたことを確認します。

      # ip route

      Copy to Clipboard Toggle word wrap

   6. 2 番目のサブネット内の各ワーカーノードに対して前の手順を繰り返します。

      注記

      実際のインターフェイス名とゲートウェイに一致するようにコマンドを調整します。

3. ネットワークを設定したら、接続をテストして、リモートワーカーノードがコントロールプレーンノードに到達できること、およびコントロールプレーンノードがリモートワーカーノードに到達できることを確認します。

   1. 次のコマンドを実行して、最初のサブネットのコントロールプレーンノードから 2 番目のサブネットのリモートワーカーノードに ping を実行します。

      $ ping <remote_worker_node_ip_address>

      Copy to Clipboard Toggle word wrap

      ping が成功した場合は、1 番目のサブネットのコントロールプレーンノードが 2 番目のサブネットのリモートワーカーノードに到達できることを意味します。応答を受信しない場合は、ネットワーク設定を確認し、ノードに対して手順を繰り返します。

   2. 次のコマンドを実行して、2 番目のサブネットのリモートワーカーノードから 1 番目のサブネットのコントロールプレーンノードに ping を実行します。

      $ ping <control_plane_node_ip_address>

      Copy to Clipboard Toggle word wrap

      ping が成功した場合は、2 番目のサブネットのリモートワーカーノードが 1 番目のサブネットのコントロールプレーンに到達できることを意味します。応答を受信しない場合は、ネットワーク設定を確認し、ノードに対して手順を繰り返します。

手順

1. 環境変数を設定します。

   $ export cmd=openshift-baremetal-install

   Copy to Clipboard Toggle word wrap

   $ export pullsecret_file=~/pull-secret.txt

   Copy to Clipboard Toggle word wrap

   $ export extract_dir=$(pwd)

   Copy to Clipboard Toggle word wrap

2. oc バイナリーを取得します。

   $ curl -s https://mirror.openshift.com/pub/openshift-v4/clients/ocp/$VERSION/openshift-client-linux.tar.gz | tar zxvf - oc

   Copy to Clipboard Toggle word wrap

3. インストーラーを実行します。

   $ sudo cp oc /usr/local/bin

   Copy to Clipboard Toggle word wrap

   $ oc adm release extract --registry-config "${pullsecret_file}" --command=$cmd --to "${extract_dir}" ${RELEASE_IMAGE}

   Copy to Clipboard Toggle word wrap

   $ sudo cp openshift-baremetal-install /usr/local/bin

   Copy to Clipboard Toggle word wrap

手順

1. podman をインストールします。

   $ sudo dnf install -y podman

   Copy to Clipboard Toggle word wrap

2. RHCOS イメージのキャッシュに使用されるファイアウォールのポート 8080 を開きます。

   $ sudo firewall-cmd --add-port=8080/tcp --zone=public --permanent

   Copy to Clipboard Toggle word wrap

   $ sudo firewall-cmd --reload

   Copy to Clipboard Toggle word wrap

3. bootstraposimage を保存するディレクトリーを作成します。

   $ mkdir /home/kni/rhcos_image_cache

   Copy to Clipboard Toggle word wrap

4. 新規に作成されたディレクトリーに適切な SELinux コンテキストを設定します。

   $ sudo semanage fcontext -a -t httpd_sys_content_t "/home/kni/rhcos_image_cache(/.*)?"

   Copy to Clipboard Toggle word wrap

   $ sudo restorecon -Rv /home/kni/rhcos_image_cache/

   Copy to Clipboard Toggle word wrap

5. インストールプログラムがブートストラップ VM にデプロイする RHCOS イメージの URI を取得します。

   $ export RHCOS_QEMU_URI=$(/usr/local/bin/openshift-baremetal-install coreos print-stream-json | jq -r --arg ARCH "$(arch)" '.architectures[$ARCH].artifacts.qemu.formats["qcow2.gz"].disk.location')

   Copy to Clipboard Toggle word wrap

6. インストールプログラムがブートストラップ VM にデプロイするイメージの名前を取得します。

   $ export RHCOS_QEMU_NAME=${RHCOS_QEMU_URI##*/}

   Copy to Clipboard Toggle word wrap

7. ブートストラップ仮想マシンにデプロイされる RHCOS イメージの SHA ハッシュを取得します。

   $ export RHCOS_QEMU_UNCOMPRESSED_SHA256=$(/usr/local/bin/openshift-baremetal-install coreos print-stream-json | jq -r --arg ARCH "$(arch)" '.architectures[$ARCH].artifacts.qemu.formats["qcow2.gz"].disk["uncompressed-sha256"]')

   Copy to Clipboard Toggle word wrap

8. イメージをダウンロードして、/home/kni/rhcos_image_cache ディレクトリーに配置します。

   $ curl -L ${RHCOS_QEMU_URI} -o /home/kni/rhcos_image_cache/${RHCOS_QEMU_NAME}

   Copy to Clipboard Toggle word wrap

9. 新しいファイルの SELinux タイプが httpd_sys_content_t であることを確認します。

   $ ls -Z /home/kni/rhcos_image_cache

   Copy to Clipboard Toggle word wrap

10. Pod を作成します。

    $ podman run -d --name rhcos_image_cache \

    1

    
    -v /home/kni/rhcos_image_cache:/var/www/html \
    -p 8080:8080/tcp \
    registry.access.redhat.com/ubi9/httpd-24

    Copy to Clipboard Toggle word wrap

    1

    rhcos_image_cache という名前のキャッシング Web サーバーを作成します。この Pod は、デプロイメント用に install-config.yaml ファイルの bootstrapOSImage イメージを提供します。

11. bootstrapOSImage 設定を生成します。

    $ export BAREMETAL_IP=$(ip addr show dev baremetal | awk '/inet /{print $2}' | cut -d"/" -f1)

    Copy to Clipboard Toggle word wrap

    $ export BOOTSTRAP_OS_IMAGE="http://${BAREMETAL_IP}:8080/${RHCOS_QEMU_NAME}?sha256=${RHCOS_QEMU_UNCOMPRESSED_SHA256}"

    Copy to Clipboard Toggle word wrap

    $ echo "    bootstrapOSImage=${BOOTSTRAP_OS_IMAGE}"

    Copy to Clipboard Toggle word wrap

12. platform.baremetal 下の install-config.yaml ファイルに必要な設定を追加します。

    platform:
      baremetal:
        bootstrapOSImage: <bootstrap_os_image>  

    1

    Copy to Clipboard Toggle word wrap

    1

    <bootstrap_os_image> を $BOOTSTRAP_OS_IMAGE の値に置き換えます。

    詳細は、Configuring the install-config.yaml file セクションを参照してください。