11.3. アシステッドインストーラーを使用したインストール
クラスターノードとネットワークの要件が満たされていることを確認したら、クラスターのインストールを開始できます。
11.3.1. インストール前の考慮事項
Assisted Installer を使用して OpenShift Container Platform をインストールする前に、以下の設定の選択を検討する必要があります。
- 使用する基本ドメイン
- インストールする OpenShift Container Platform の製品バージョン
- フルクラスターまたは単一ノードの OpenShift をインストールするかどうか
- DHCP サーバーまたは静的ネットワーク設定を使用するかどうか
- IPv4 またはデュアルスタックネットワークを使用するかどうか
- OpenShift Virtualization をインストールするかどうか
- Red Hat OpenShift Data Foundation をインストールするかどうか
- vSphere へのインストール時に vSphere と統合するかどうか
11.3.2. クラスターの詳細の設定
Assisted Installer Web ユーザーインターフェイスを使用してクラスターを作成するには、次の手順を使用します。
手順
- RedHat Hybrid Cloud Console にログインします。
- メニューで OpenShift をクリックします。
- Create cluster をクリックします。
- Datacenter タブをクリックします。
- Assisted Installer セクションで、Create cluster を選択します。
- Cluster Name フィールドにクラスターの名前を入力します。
Base domain フィールドに、クラスターのベースドメインを入力します。クラスターのすべてのサブドメインは、この基本ドメインを使用します。
注記ベースドメインは有効な DNS 名である必要があります。ベースドメインにワイルドカードドメインをセットアップしないでください。
- インストールする OpenShift Container Platform のバージョンを選択します。
- オプション: OpenShift Container Platform を単一のノードにインストールする場合は、Install single node Openshift (SNO) を選択します。
- オプション: アシステッドインストーラーには、アカウントに関連付けられたプルシークレットがすでにあります。別のプルシークレットを使用する場合は、Edit pull secret を選択します。
- オプション: アシステッドインストーラーは、デフォルトで x86_64 CPU アーキテクチャーを使用します。OpenShift Container Platform を 64 ビット ARM CPU にインストールする場合は、Use arm64 CPU architecture を選択します。一部の機能は、AArch64 CPU アーキテクチャーでは使用できないことに注意してください。
- オプション: DHCP 予約の代わりにクラスターノードに静的 IP 設定を使用している場合は、Static network configuration を選択します。
- オプション: インストールディスクの暗号化を有効にする場合は、Enable encryption of installation disks を選択します。マルチノードクラスターの場合、コントロールプレーンとワーカーノードのインストールディスクを別々に暗号化することを選択できます。
インストールの開始後は、基本ドメイン、SNO チェックボックス、CPU アーキテクチャー、ホストのネットワーク設定、またはディスク暗号化を変更できません。
11.3.3. オプション: ホストネットワークインターフェイスの設定
アシステッドインストーラーは、IPv4 ネットワークとデュアルスタックネットワークをサポートします。アシステッドインストーラーは、ホスト用の宣言型ネットワークマネージャー API である NMState ライブラリーを使用したホストネットワークインターフェイスの設定もサポートしています。NMState を使用して、静的 IP アドレス指定、ボンディング、VLAN、およびその他の高度なネットワーク機能を備えたホストをデプロイできます。ホストネットワークインターフェイスを設定することを選択した場合は、ネットワーク全体の設定を設定する必要があります。次に、ホストごとにホスト固有の設定を作成し、ホスト固有の設定で検出 ISO を生成する必要があります。
手順
- インターネットプロトコルのバージョンを選択します。有効なオプションは IPv4 と Dual stack です。
- クラスターホストが共有 VLAN 上にある場合は、VLAN ID を入力します。
ネットワーク全体の IP アドレスを入力します。Dual stack ネットワークを選択した場合は、IPv4 と IPv6 の両方のアドレスを入力する必要があります。
- クラスターネットワークの IP アドレス範囲を CIDR 表記で入力します。
- デフォルトゲートウェイの IP アドレスを入力します。
- DNS サーバーの IP アドレスを入力します。
ホスト固有の設定を入力します。
- 単一のネットワークインターフェイスを使用する静的 IP アドレスのみを設定する場合は、フォームビューを使用して、ホストの IP アドレスと MAC アドレスを入力します。
- 複数のインターフェイス、ボンディング、またはその他の高度なネットワーク機能を使用している場合は、YAML ビューを使用し、NMState 構文を使用してホストに必要なネットワーク状態を入力します。
- ネットワーク設定で使用される各インターフェイスの MAC アドレスとインターフェイス名を追加します。
11.3.4. クラスターへのホストの追加
1 つ以上のホストをクラスターに追加する必要があります。クラスターにホストを追加するには、検出 ISO を生成する必要があります。検出 ISO は、エージェントを使用して Red Hat Enterprise Linux CoreOS (RHCOS) インメモリーを実行します。クラスター上の各ホストに対して次の手順を実行します。
手順
Add hosts ボタンをクリックし、インストールメディアを選択します。
- Minimal image file: Provision with virtual media を選択して、起動に必要なデータを取得する小さなイメージをダウンロードします。ノードには仮想メディア機能が必要です。これは推奨される方法です。
- Full image file: Provision with physical media を選択して、より大きなフルイメージをダウンロードします。
-
core
ユーザーとしてクラスターノードに接続できるように、SSH 公開キーを追加します。クラスターノードにログインすると、インストール中にデバッグ情報を入手できます。 - オプション: クラスターホストがプロキシーの使用を必要とするファイアウォールの内側にある場合は、Configure cluster-wide proxy settings を選択します。プロキシーサーバーの HTTP および HTTPS URL のユーザー名、パスワード、IP アドレス、およびポートを入力します。
- Generate Discovery ISO をクリックします。
- 検出 ISO をダウンロードします。
11.3.5. USB ドライブに ISO イメージを作成する
ISO イメージを含む USB ドライブを使用してソフトウェアをインストールできます。USB ドライブを使用してサーバーを起動すると、ソフトウェアをインストールするサーバーの準備が整います。
手順
- 管理ホストで、USB ドライブを USB ポートに挿入します。
USB ドライブに ISO イメージを作成します。以下に例を示します。
# dd if=<path_to_iso> of=<path_to_usb> status=progress
ここでは、以下のようになります。
- <path_to_iso>
-
rhcos-live.iso
など、ダウンロードした ISO ファイルへの相対パスです。 - <path_to_usb>
/dev/sdb
など、接続された USB ドライブの場所です。ISO が USB ドライブにコピーされたら、USB ドライブを使用してサーバーにソフトウェアをインストールできます。
11.3.6. USB ドライブでの起動
起動可能な USB ドライブを使用して Assisted Installer にノードを登録するには、次の手順を使用します。
手順
- RHCOS 検出 ISO をターゲットホストにアタッチします。
- サーバーの BIOS 設定で起動ドライブの順序を設定し、アタッチされた検出 ISO から起動して、サーバーを再起動します。
- 管理ホストで、ブラウザーに戻ります。ホストが、検出されたホストのリストに表示されるまで待ちます。
11.3.7. Redfish API を使用した HTTP ホスト ISO イメージからの起動
Redfish Baseboard Management Controller (BMC) API を使用してインストールした ISO を使用して、ネットワーク内のホストをプロビジョニングできます。
前提条件
- インストール Red Hat Enterprise Linux CoreOS (RHCOS) ISO をダウンロードしている。
手順
- ネットワークでアクセス可能な HTTP サーバーに ISO ファイルをコピーします。
ホストされている ISO ファイルからホストを起動します。以下に例を示します。
次のコマンドを実行して、redfish API を呼び出し、ホストされている ISO を
VirtualMedia
ブートメディアとして設定します。$ curl -k -u <bmc_username>:<bmc_password> -d '{"Image":"<hosted_iso_file>", "Inserted": true}' -H "Content-Type: application/json" -X POST <host_bmc_address>/redfish/v1/Managers/iDRAC.Embedded.1/VirtualMedia/CD/Actions/VirtualMedia.InsertMedia
詳細は以下のようになります。
- <bmc_username>:<bmc_password>
- ターゲットホスト BMC のユーザー名とパスワードです。
- <hosted_iso_file>
-
ホストされたインストール ISO の URL です (例:
http://webserver.example.com/rhcos-live-minimal.iso
)。ISO は、ターゲットホストマシンからアクセスできる必要があります。 - <host_bmc_address>
- ターゲットホストマシンの BMC IP アドレスです。
次のコマンドを実行して、
VirtualMedia
デバイスから起動するようにホストを設定します。$ curl -k -u <bmc_username>:<bmc_password> -X PATCH -H 'Content-Type: application/json' -d '{"Boot": {"BootSourceOverrideTarget": "Cd", "BootSourceOverrideMode": "UEFI", "BootSourceOverrideEnabled": "Once"}}' <host_bmc_address>/redfish/v1/Systems/System.Embedded.1
ホストを再起動します。
$ curl -k -u <bmc_username>:<bmc_password> -d '{"ResetType": "ForceRestart"}' -H 'Content-type: application/json' -X POST <host_bmc_address>/redfish/v1/Systems/System.Embedded.1/Actions/ComputerSystem.Reset
オプション: ホストの電源がオフになっている場合は、
{"ResetType": "On"}
スイッチを使用して起動できます。以下のコマンドを実行します。$ curl -k -u <bmc_username>:<bmc_password> -d '{"ResetType": "On"}' -H 'Content-type: application/json' -X POST <host_bmc_address>/redfish/v1/Systems/System.Embedded.1/Actions/ComputerSystem.Reset
11.3.8. ホストの設定
検出 ISO を使用してホストを起動すると、ページの下部にあるテーブルにホストが表示されます。各ホストのホスト名、ロール、およびインストールディスクを設定できます。
手順
- ホストを選択します。
- Actions リストから、Change hostname を選択します。各ホストに有効で一意のホスト名があることを確認する必要があります。必要に応じて、ホストの新しい名前を入力し、Change をクリックします。
マルチホストクラスターの場合、ホスト名の横にある Role 列で、メニューをクリックしてホストのロールを変更できます。
ロールを選択しない場合、Assisted Installer がロールを自動的に割り当てます。コントロールプレーンノードの最小ハードウェア要件は、ワーカーノードの要件を超えています。ホストにロールを割り当てる場合は、ハードウェアの最小要件を満たすホストにコントロールプレーンのロールを割り当てるようにしてください。
- ホスト名の横にあるチェックボックスの左側をクリックして、ホストの詳細を展開します。複数のディスクドライブがある場合は、別のディスクドライブを選択して、インストールディスクとして機能させることができます。
- ホストごとにこの手順を繰り返します。
すべてのクラスターホストが Ready のステータスで表示されたら、次の手順に進みます。
11.3.9. ネットワークの設定
OpenShift Container Platform をインストールする前に、クラスターネットワークを設定する必要があります。
手順
Networking ページで、まだ選択されていない場合は、次のいずれかを選択します。
-
クラスター管理ネットワーク: クラスター管理ネットワークを選択すると、アシステッドインストーラーは、API および Ingress VIP アドレスを管理するための
keepalived
および Virtual Router Redundancy Protocol (VRRP) を含む標準ネットワークトポロジーを設定することを意味します。 -
User-Managed Networking: ユーザー管理のネットワークを選択すると、OpenShift Container Platform を非標準のネットワークトポロジーでデプロイできます。たとえば、
keepalived
や VRRP の代わりに外部ロードバランサーを使用してデプロイする場合や、多数の異なる L2 ネットワークセグメントにクラスターノードをデプロイする場合などです。
-
クラスター管理ネットワーク: クラスター管理ネットワークを選択すると、アシステッドインストーラーは、API および Ingress VIP アドレスを管理するための
クラスター管理ネットワークの場合は、以下の設定を設定します。
- マシンネットワーク を定義します。デフォルトのネットワークを使用するか、サブネットを選択できます。
- API 仮想 IP を定義します。API 仮想 IP は、すべてのユーザーが対話し、プラットフォームを設定するためのエンドポイントを提供します。
- Ingress 仮想 IP を定義します。Ingress 仮想 IP は、クラスターの外部から流れるアプリケーショントラフィックのエンドポイントを提供します。
ユーザー管理のネットワークの場合は、次の設定を設定します。
Networking stack type を選択します。
- IPv4 : ホストが IPv4 のみを使用している場合は、このタイプを選択します。
- デュアルスタック: ホストが IPv4 と IPv6 を併用している場合、デュアルスタックを選択できます。
- マシンネットワーク を定義します。デフォルトのネットワークを使用するか、サブネットを選択できます。
- API 仮想 IP を定義します。API 仮想 IP は、すべてのユーザーが対話し、プラットフォームを設定するためのエンドポイントを提供します。
- Ingress 仮想 IP を定義します。Ingress 仮想 IP は、クラスターの外部から流れるアプリケーショントラフィックのエンドポイントを提供します。
- オプション: Allocate IPs via DHCP server を選択して、DHCP サーバーを使用して API IP と Ingress IP を自動的に割り当てることができます。
オプション: Use advanced networking を選択して、以下の高度なネットワークプロパティーを設定します。
- クラスターネットワーク CIDR: Pod IP アドレスが割り当てられる IP アドレスブロックを定義します。
- クラスターネットワークホストプリフィックス: 各ノードに割り当てるサブネットプリフィックス長を定義します。
- サービスネットワーク CIDR: サービス IP アドレスに使用する IP アドレスを定義します。
- Network type: 標準ネットワーク用の Software-Defined Networking (SDN) または Telco 機能用の Open Virtual Networking (OVN) のいずれかを選択します。
11.3.10. クラスターのインストール
設定が完了し、すべてのノードが Ready になったら、インストールを開始できます。インストールプロセスにはかなりの時間がかかりますが、Assisted Installer Web コンソールからインストールを監視できます。ノードはインストール中に再起動し、インストール後に初期化されます。
手順
Begin installation を押します。
- 特定のホストのインストールステータスを表示するには、Host Inventory リストの Status 列のリンクをクリックします。
11.3.11. インストールの完了
クラスターがインストールされて初期化されると、Assisted Installer はインストールが完了したことを示します。Assisted Installer は、コンソール URL、kubeadmin
のユーザー名とパスワード、および kubeconfig
ファイルを提供します。さらに、Assisted Installer は、OpenShift Container Platform バージョン、ベースドメイン、CPU アーキテクチャー、API および Ingress IP アドレス、クラスターおよびサービスネットワーク IP アドレスを含むクラスターの詳細を提供します。
前提条件
-
oc
CLI ツールがインストールされている。
手順
-
kubeadmin
のユーザー名とパスワードのコピーを作成します。 kubeconfig
ファイルをダウンロードして、作業ディレクトリーの下のauth
ディレクトリーにコピーします。$ mkdir -p <working_directory>/auth
$ cp kubeadmin <working_directory>/auth
注記kubeconfig
ファイルは、インストールの完了後 24 時間はダウンロードできます。kubeconfig
ファイルをお使いの環境に追加します。$ export KUBECONFIG=<your working directory>/auth/kubeconfig
oc
CLI ツールでログインします。$ oc login -u kubeadmin -p <password>
<password>
をkubeadmin
ユーザーのパスワードに置き換えます。- Web コンソールの URL をクリックするか、Launch OpenShift Console をクリックしてコンソールを開きます。
-
kubeadmin
のユーザー名とパスワードを入力します。OpenShift Container Platform コンソールの指示に従って、アイデンティティープロバイダーを設定し、アラートレシーバーを設定します。 - OpenShift Container Platform コンソールのブックマークを追加します。