第4章 インストール


4.1. OpenShift Virtualization のクラスターの準備

OpenShift Virtualization をインストールする前に、プラットフォームの互換性情報を確認します。詳細なシステム要件については、関連情報セクションの「ハードウェア、ソフトウェア、および運用要件」を参照してください。

4.1.1. 互換性のあるプラットフォーム

OpenShift Virtualization は、ベアメタルサーバー、ARM64 ベースのシステム、および論理パーティション内の IBM Z®または IBM® LinuxONE システムをサポートします。

互換性のあるプラットフォーム
  • オンプレミスのベアメタルサーバー。詳細は、関連情報セクションの「OpenShift Virtualization のためのベアメタルクラスターの計画」を参照してください。
  • ARM64 ベース (arm64、aarch64 とも呼ばれる) システムにインストールされたベアメタルクラスター。
  • OpenShift Container Platform クラスターが論理パーティション (LPAR) にインストールされている IBM Z® または IBM® LinuxONE (s390x アーキテクチャー) システム。詳細は、関連情報セクションの「BM Z および IBM LinuxONE へのインストールの準備」を参照してください。

4.1.2. クラウドプラットフォーム

OpenShift Virtualization は、さまざまなパブリッククラウドプラットフォームと互換性があります。各プラットフォームには、それぞれ固有のストレージオプションが用意されています。

ベンターステータスストレージリソース

Amazon Web Services (AWS)

GA

  • Elastic Block Store (EBS)
  • Red Hat OpenShift Data Foundation (ODF)
  • Portworx
  • FSx (NetApp)
  • 関連情報セクションの「カスタマイズを使用した AWS 上のクラスターのインストール」を参照してください。

Red Hat OpenShift Service on AWS (ROSA)

GA

  • EBS
  • Portworx
  • FSx (Q3)
  • ODF

Oracle Cloud Infrastructure (OCI)

GA

  • OCI ネイティブストレージ

Azure Red Hat OpenShift (ARO)

GA

  • ODF

Google Cloud

一般提供開始 (OpenShift Virtualization 4.21.1 より)

  • Google Cloud ネイティブストレージ
  • Google Cloud NetApp Volumes (GCNV): OpenShift Virtualization 4.21.2 以降が必要

他のクラウドプロバイダーが提供するベアメタルインスタンスまたはサーバーはサポートされていません。

ヒント

プラットフォーム固有のネットワーク情報については、関連情報セクションの「ネットワークの概要」を参照してください。

4.1.3. AWS ベアメタル上の OpenShift Virtualization

OpenShift Virtualization は、Amazon Web Services (AWS) ベアメタル OpenShift Container Platform クラスターで実行できます。

注記

OpenShift Virtualization は、AWS ベアメタルクラスターと同じ設定要件を持つ Red Hat OpenShift Service on AWS (ROSA) Classic クラスターでもサポートされています。

クラスターを設定する前に、サポート対象の機能と制限に関する以下の要約を確認してください。

インストール
  • インストーラーでプロビジョニングされるインフラストラクチャーを使用してクラスターをインストールし、ワーカーノードにベアメタルインスタンスタイプを指定する必要があります。たとえば、x86_64 アーキテクチャーをベースとするマシンの c5n.metal タイプの値を使用できます。install-config.yaml ファイルを編集して、ベアメタルインスタンスタイプを指定します。

    詳細は、AWS へのインストールに関する OpenShift Container Platform ドキュメントを参照してください。

仮想マシン (VM) へのアクセス
  • virtctl CLI ツールまたは OpenShift Container Platform Web コンソールを使用して仮想マシンにアクセスする方法に変更はありません。
  • NodePort または LoadBalancer サービスを使用して、仮想マシンを公開できます。

    注記

    OpenShift Container Platform は AWS でロードバランサーを自動的に作成し、そのライフサイクルを管理するため、ロードバランサーのアプローチが推奨されます。また、セキュリティーグループはロードバランサー用にも作成され、アノテーションを使用して既存のセキュリティーグループをアタッチできます。サービスを削除すると、OpenShift Container Platform はロードバランサーとそれに関連付けられたリソースを削除します。

ネットワーク
  • Single Root I/O Virtualization (SR-IOV) またはブリッジ Container Network Interface (CNI) ネットワーク (仮想 LAN (VLAN) を含む) は使用できません。アプリケーションにフラットレイヤー 2 ネットワークが必要な場合や、IP プールを制御する必要がある場合は、OVN-Kubernetes セカンダリーオーバーレイネットワークを使用することを検討してください。
  • アプリケーションで Egress トラフィックを必要としないフラットなレイヤー 2 ネットワークが必要な場合は、Layer2 トポロジーで OVN-Kubernetes セカンダリーオーバーレイネットワークを使用することを検討してください。
ストレージ
  • 基盤となるプラットフォームとの連携がストレージベンダーによって認定されている任意のストレージソリューションを使用できます。

    重要

    AWS ベアメタル、Red Hat OpenShift Service on AWS、および Red Hat OpenShift Service on AWS クラシックアーキテクチャーの各クラスターで、サポートされるストレージソリューションが異なる場合があります。ストレージベンダーにサポートを確認してください。

Hosted Control Plane (HCP)
  • AWS ベアメタルノードを使用する HCP クラスター上で OpenShift Virtualization を実行できます。ただし、現在 AWS では HCP ノードとしての OpenShift Virtualization VM の使用はサポートされていません。

4.1.4. ARM64 の互換性

ARM64 システム上の OpenShift Virtualization は、オペレーティングシステムおよびライブマイグレーションに関する特定の制約付きで一般提供開始 (GA) となりました。

ARM64 ベースのシステムで OpenShift Virtualization を使用する前に、次の制限に留意してください。

オペレーティングシステム
ライブマイグレーション
  • ライブマイグレーションは、ARM64 ベースの OpenShift Container Platform クラスターでは サポートされていません。
  • ホットプラグはライブマイグレーションに依存するため、ARM64 ベースのクラスターではサポートされていません。
仮想マシンの作成
  • RHEL 10 は、インスタンスタイプと設定をサポートしますが、テンプレートはサポートしていません。
  • RHEL 9 は、テンプレート、インスタンスタイプ、および設定をサポートします。

4.1.5. IBM Z と IBM LinuxONE の互換性

IBM Z® または IBM® LinuxONE (s390x アーキテクチャー) システム上の論理パーティション (LPAR) にインストールされている OpenShift Container Platform クラスターで OpenShift Virtualization を使用できます。

一部の機能は現在 s390x アーキテクチャーでは利用できず、別の機能は回避策や手順の変更が必要です。これらのリストは変更される可能性があります。

現在利用できない機能

以下の機能は現在、s390x アーキテクチャーでは利用できません。

  • メモリーのホットプラグとホットアンプラグ
  • Node Health Check Operator
  • SR-IOV Operator
  • PCI パススルー
  • OpenShift Virtualization クラスターチェックアップフレームワーク
  • FIPS モードでインストールされたクラスター上の OpenShift Virtualization
  • IPv6
  • IBM® Storage Scale
  • OpenShift Virtualization 用の Hosted Control Plane
  • HugePages を使用した仮想マシンページ

    次の機能は s390x アーキテクチャーには適用されません。

  • 仮想 Trusted Platform Module (vTPM) デバイス
  • 仮想マシンの UEFI モード
  • USB ホストパススルー
  • 仮想 GPU の設定
  • Windows 仮想マシンの作成と管理
  • Hyper-V
機能の違い

以下の機能は s390x アーキテクチャーで使用できますが、動作が異なるか、手順の変更が必要です。

  • Web コンソールを使用して仮想マシンを削除する場合、猶予期間 オプションは無視されます。詳細は、関連情報セクションの「Web コンソールを使用した仮想マシンの削除」を参照してください。
  • デフォルトの CPU モデルを設定する場合、IBM Z クラスターの spec.defaultCPUModel 値は "gen15b" です。詳細は、関連情報セクションの「デフォルトの CPU モデルの設定」を参照してください。
  • downward metrics デバイスを設定する際に、仮想マシン設定を使用する場合は、spec.preference.name 値に、rhel.9.s390x または *.s390x という形式の使用可能な別の設定を指定する必要があります。詳細については、関連情報 セクションの「ダウンしたメトリクスデバイスの設定」を参照してください。
  • インスタンスタイプから仮想マシンを作成する場合、メモリーのホットプラグが IBM Z® でサポートされていないため、spec.domain.memory.maxGuest を設定することは許可されていません。詳細は、関連情報セクションの「インスタンスタイプからの仮想マシンの作成」を参照してください。
  • 仮想マシンゲストに対する Prometheus クエリーは、x86 と比較して一貫性のない結果になる可能性があります。

4.1.6. デプロイメントに関する考慮事項

OpenShift Virtualization をインストールする前に、プラットフォームの要件と設定の制約を確認し、ストレージ、ネットワーク、およびセキュリティー機能に関連するデプロイメントの問題が発生するのを回避します。

インストール方法の考慮事項
OpenShift Container Platform は、ユーザープロビジョニング、インストーラープロビジョニング、Assisted Installer など、任意のインストール方法を使用してデプロイできます。ただし、インストール方法とクラスタートポロジーは、スナップショットやライブマイグレーションなどの OpenShift Virtualization 機能に影響を与える可能性があります。ライブマイグレーションの詳細は、関連情報セクションの「ハードウェア、ソフトウェア、および運用要件」を参照してください。
Red Hat OpenShift Data Foundation
Red Hat OpenShift Data Foundation を使用して OpenShift Virtualization をデプロイする場合は、Windows 仮想マシンディスク用の専用ストレージクラスを作成する必要があります。詳細は、関連情報セクションの「Optimizing ODF PersistentVolumes for Windows VMs」を参照してください。
IPv6
シングルスタック IPv6 クラスターに対する OpenShift Virtualization のサポートは、OVN-Kubernetes localnet および Linux ブリッジ Container Network Interface (CNI) プラグインに限定されています。
重要

{FeatureName} はテクノロジープレビュー機能としてのみご利用いただけます。テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は、実稼働環境でこれらを使用することを推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行い、フィードバックを提供していただくことを目的としています。

Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲 を参照してください。

FIPS モード
クラスターを FIPS モードでインストールする場合、OpenShift Virtualization に追加の設定は必要ありません。詳細は、関連情報セクションの「FIPS 準拠クラスターのインストール」を参照してください。

4.1.7. オブジェクトの最大値

クラスターを計画する際には、OpenShift Container Platform と OpenShift Virtualization の両方について、テスト済みのオブジェクト数の上限を考慮してください。

OpenShift Container Platform
関連情報セクションの「OpenShift Container Platform オブジェクトの最大値」を参照してください。
OpenShift Virtualization
関連情報セクションの「OpenShift Virtualization でサポートされる制限」を参照してください。

4.2. ハードウェア、ソフトウェア、および運用要件

OpenShift Virtualization のハードウェア、ソフトウェア、および運用要件 (CPU、OS、ストレージ、クラスターサイジング、ライブマイグレーションなど) を確認してください。

4.2.1. CPU の要件

OpenShift Virtualization を利用するには、特定の仮想化拡張機能が有効な Red Hat Enterprise Linux (RHEL) 9 でサポートされている CPU が必要です。

OpenShift Virtualization の CPU 要件
  • Red Hat Enterprise Linux (RHEL) 9 でサポートされている必要がある。サポートされている CPU の Red Hat Ecosystem Catalog を参照してください。

    注記

    ワーカーノードの CPU が異なる場合は、CPU ごとに機能が異なるため、ライブマイグレーションが失敗する可能性があります。この問題は、ワーカーノードに適切な容量の CPU が搭載されていることを確認し、仮想マシンのノードアフィニティールールを設定することで軽減できます。

    詳細は、関連情報セクションの「ノードアフィニティーの required (必須) ルールの設定」を参照してください。

  • AMD64、Intel 64 ビット (x86-64-v2)、IBM Z® (s390x)、または ARM64 ベース (arm64 または aarch64) アーキテクチャーとそれぞれの CPU 拡張機能のサポートがある。
  • Intel VT-x、AMD-V、または ARM 仮想化拡張機能が有効になっているか、s390x 仮想化サポートが有効になっている。
  • NX (実行なし) フラグが有効になっている。
  • s390x アーキテクチャーを使用する場合、デフォルトの CPU モデルが gen15b に設定されている。詳細は、関連情報セクションの「デフォルトの CPU モデルの設定」を参照してください。

4.2.2. オペレーティングシステム要件

OpenShift Virtualization では、ワーカーノードに Red Hat Enterprise Linux CoreOS(RHCOS) が必要です。RHEL ワーカーノードはサポートされていません。

詳細は、関連情報セクションの「RHCOS について」を参照してください。

4.2.3. ストレージ要件

OpenShift Virtualization では、OpenShift Container Platform でサポートされているストレージと、仮想マシンワークロードおよびスナップショット用の特定の設定が必要です。

OpenShift Virtualization のストレージ要件
  • ストレージは OpenShift Container Platform によってサポートされている必要があります。詳細は、関連情報セクションの「ストレージの最適化」を参照してください。
  • デフォルトの OpenShift Virtualization または OpenShift Container Platform ストレージクラスを作成する必要があります。これは、仮想マシンワークロード固有のストレージニーズに対応し、最適化されたパフォーマンス、信頼性、ユーザーエクスペリエンスを提供することを目的としています。OpenShift Virtualization と OpenShift Container Platform の両方にデフォルトのストレージクラスが存在する場合、仮想マシンディスクの作成時には OpenShift Virtualization のクラスが優先されます。

    注記

    ストレージクラスを仮想化ワークロードのデフォルトとしてマークするには、アノテーション storageclass.kubevirt.io/is-default-virt-class を "true" に設定します。

  • ストレージプロビジョナーがスナップショットをサポートしている場合は、VolumeSnapshotClass オブジェクトをデフォルトのストレージクラスに関連付ける必要があります。

4.2.3.1. Windows 仮想マシンのストレージ I/O レイテンシー要件

Windows ゲストオペレーティングシステムでは、安定した状態を維持するために、一貫して低いストレージ I/O レイテンシーが必要です。基盤となるストレージのレイテンシーが次のしきい値を超えると、Windows 仮想マシンが不安定またはクラッシュする可能性があります。

表4.1 Windows 仮想マシンの Storage I/O レイテンシーのしきい値
Storage I/O レイテンシー影響

15 ミリ秒未満

正常ストレージのパフォーマンスは、安定した仮想マシンの操作において想定される範囲内です。

15 ミリ秒から 100 ミリ秒未満

異常このしきい値を超えると、最終的にワークロードの不安定やクラッシュが発生する可能性があります。

100 ms から 1,000 ミリ秒未満

Windowsのクラッシュが発生する可能性が高くなります。

1,000 ミリ秒以上

Windows のクラッシュはほぼ確実に発生します。

注記

ストレージ I/O レイテンシーが 1 日 100 ミリ秒を超える場合は、レイテンシーの根本原因を特定することを優先します。影響を受けるワークロードのトラブルシューティングは、根本的なレイテンシーの問題を解決するまでセカンダリーの問題です。

4.2.3.2. 仮想マシンディスクのボリュームおよびアクセスモード

既知のストレージプロバイダーでストレージ API を使用する場合、ボリュームモードとアクセスモードは自動的に選択されます。ただし、ストレージプロファイルのないストレージクラスを使用する場合は、ボリュームとアクセスモードを設定する必要があります。

OpenShift Virtualization に対応している既知のストレージプロバイダーのリストは、Red Hat Ecosystem Catalog を参照してください。

最良の結果を得るには、ReadWriteMany (RWX) アクセスモードと Block ボリュームモードを使用してください。これは、以下の理由により重要です。

  • ライブマイグレーションには ReadWriteMany (RWX) アクセスモードが必要です。
  • Block ボリュームモードは、Filesystem ボリュームモードよりもパフォーマンスが大幅に優れています。これは、Filesystem ボリュームモードでは、ファイルシステムレイヤーやディスクイメージファイルなどを含め、より多くのストレージレイヤーが使用されるためです。仮想マシンのディスクストレージに、これらのレイヤーは必要ありません。

    たとえば、Red Hat OpenShift Data Foundation を使用する場合は、CephFS ボリュームよりも Ceph RBD ボリュームの方が推奨されます。

重要

次の設定の仮想マシンをライブマイグレーションすることはできません。

  • ReadWriteOnce (RWO) アクセスモードのストレージボリューム
  • GPU などのパススルー機能

これらの仮想マシンの evictionStrategy フィールドを None に設定します。None ストラテジーでは、ノードの再起動中に仮想マシンの電源がオフになります。

4.2.4. 物理リソースのオーバーヘッド要件

OpenShift Virtualization は OpenShift Container Platform のアドオンであり、クラスターの計画時に考慮する必要のある追加のオーバーヘッドを強要します。

各クラスターマシンは、OpenShift Container Platform の要件に加えて、以下のオーバーヘッドの要件を満たす必要があります。クラスター内の物理リソースを過剰にサブスクライブすると、パフォーマンスに影響する可能性があります。

重要

このドキュメントに記載されている数は、Red Hat のテスト方法およびセットアップに基づいています。これらの数は、独自のセットアップおよび環境に応じて異なります。

4.2.4.1. メモリーのオーバーヘッド

以下の式を使用して、OpenShift Virtualization のメモリーオーバーヘッドの値を計算します。

クラスターメモリーのオーバーヘッド
Memory overhead per infrastructure node ≈ 150 MiB
Memory overhead per worker node ≈ 360 MiB

さらに、OpenShift Virtualization 環境リソースには、すべてのインフラストラクチャーノードに分散される合計 2179 MiB の RAM が必要です。

仮想マシンのメモリーオーバーヘッド
Memory overhead per virtual machine ≈ (0.002 × requested memory) \
              + 218 MiB \
              + 8 MiB × (number of vCPUs) \
              + 16 MiB × (number of graphics devices) \
              + (additional memory overhead)
  • virt-launcher Pod で実行されるプロセスには 218 MiB が必要です。
  • 8 MiB × (number of vCPUs) は、仮想マシンが要求する仮想 CPU の数を指します。
  • 16 MiB × (number of graphics devices) は、仮想マシンが要求する仮想グラフィックカードの数を指します。
  • 追加のメモリーオーバーヘッド:

    • お使いの環境に Single Root I/O Virtualization (SR-IOV) ネットワークデバイスまたは Graphics Processing Unit (GPU) が含まれる場合、それぞれのデバイスに 1 GiB の追加のメモリーオーバーヘッドを割り当てます。
    • Secure Encrypted Virtualization (SEV) が有効な場合は、256 MiB を追加します。
    • Trusted Platform Module (TPM) が有効な場合は、53 MiB を追加します。

4.2.4.2. CPU オーバーヘッド

以下の式を使用して、OpenShift Virtualization のクラスタープロセッサーのオーバーヘッド要件を計算します。仮想マシンごとの CPU オーバーヘッドは、個々の設定によって異なります。

クラスターの CPU オーバーヘッド
CPU overhead for infrastructure nodes ≈ 4 cores

OpenShift Virtualization は、ロギング、ルーティング、およびモニタリングなどのクラスターレベルのサービスの全体的な使用率を増加させます。このワークロードに対応するには、インフラストラクチャーコンポーネントをホストするノードに、4 つの追加コア (4000 ミリコア) の容量があり、これがそれらのノード間に分散されていることを確認します。

CPU overhead for worker nodes ≈ 2 cores + CPU overhead per virtual machine

仮想マシンをホストする各ワーカーノードには、仮想マシンのワークロードに必要な CPU に加えて、OpenShift Virtualization 管理ワークロード用に 2 つの追加コア (2000 ミリコア) の容量が必要です。

仮想マシンの CPU オーバーヘッド
専用の CPU が要求される場合は、仮想マシン 1 台につき CPU 1 つとなり、クラスターの CPU オーバーヘッド要件に影響が出てきます。それ以外の場合は、仮想マシンに必要な CPU の数に関する特別なルールはありません。

4.2.4.3. ストレージのオーバーヘッド

以下のガイドラインを使用して、OpenShift Virtualization 環境のストレージオーバーヘッド要件を見積もります。

クラスターストレージオーバーヘッド
Aggregated storage overhead per node ≈ 10 GiB

10 GiB は、OpenShift Virtualization のインストール時にクラスター内の各ノードに関するディスク上のストレージの予想される影響に相当します。

仮想マシンのストレージオーバーヘッド
仮想マシンごとのストレージオーバーヘッドは、仮想マシン内のリソース割り当ての特定の要求により異なります。この要求は、クラスター内の別の場所でホストされるノードまたはストレージリソースのエフェメラルストレージに対するものである可能性があります。OpenShift Virtualization は現在、実行中のコンテナー自体に追加のエフェメラルストレージを割り当てていません。
例
クラスター管理者が、クラスター内の 10 台の (それぞれ 1 GiB の RAM と 2 つの仮想 CPU の) 仮想マシンをホストする予定の場合、クラスター全体で影響を受けるメモリーは 11.68 GiB になります。クラスターの各ノードについて予想されるディスク上のストレージの影響は 10 GiB で示され、仮想マシンのワークロードをホストするワーカーノードに関する CPU の影響は最小 2 コアで示されます。

4.2.5. 単一ノードの OpenShift 機能のサポート

OpenShift Virtualization はシングルノード OpenShift にインストールできます。トポロジーは、高可用性、Pod の中断、ライブマイグレーション、またはエビクションストラテジーをサポートしません。

ただし、シングルノード OpenShift は次の機能をサポートしていないことに注意してください。

  • 高可用性
  • Pod の中断
  • ライブマイグレーション
  • エビクションストラテジーが設定されている仮想マシンまたはテンプレート

4.2.6. オブジェクトの最大値

クラスターを計画する際には、OpenShift Container Platform と OpenShift Virtualization の両方について、テスト済みのオブジェクト数の上限を考慮してください。

OpenShift Container Platform
関連情報セクションの「OpenShift Container Platform オブジェクトの最大値」を参照してください。
OpenShift Virtualization
関連情報セクションの「OpenShift Virtualization でサポートされる制限」を参照してください。

4.2.7. ライブマイグレーションの要件

ライブマイグレーションには、共有ストレージ、十分なリソース、およびノード間で互換性のある CPU が必要です。

ライブマイグレーションの要件
  • ReadWriteMany (RWX) アクセスモードの共有ストレージ
  • 十分な RAM およびネットワーク帯域幅

    注記

    ノードの drain (Pod の退避) 実行に伴うライブマイグレーションを実行できるように、クラスター内に十分なメモリーリクエスト容量があることを確認する必要があります。以下の計算を使用して、必要な予備のメモリーを把握できます。

    Product of (Maximum number of nodes that can drain in parallel) and (Highest total VM memory request allocations across nodes)

    クラスターで並行して実行できるデフォルトの移行数は 5 です。詳細は、関連情報セクションの「ライブマイグレーションの設定」を参照してください。

  • 仮想マシンが host model CPU を使用する場合、ノードは仮想マシンのホストモデルの CPU をサポートする必要があります。
注記

ライブマイグレーション専用の Multus ネットワークを強く推奨します。詳細は、関連情報セクションの「ライブマイグレーション用の専用ネットワークの使用」を参照してください。専用ネットワークは、移行中のテナントワークロードに対するネットワークの飽和状態の影響を最小限に抑えます。

4.2.8. クラスターの高可用性オプション

installer-provisioned infrastructure (IPI)、Node Health Check Operator、または手動監視を使用して、クラスターの高可用性 (HA) を設定します。

HA を設定する方法
  • installer-provisioned infrastructure の自動高可用性は、マシンヘルスチェックをデプロイすることで利用できます。詳細は、「関連情報」セクションの「installer-provisioned infrastructure のインストール概要」を参照してください。

    注記

    インストーラーによってプロビジョニングされたインフラストラクチャーを使用し、適切に設定された MachineHealthCheck リソースを使用してインストールされた OpenShift Container Platform クラスターでは、ノードがマシンヘルスチェックに失敗し、クラスターで使用できなくなった場合、そのノードはリサイクルされます。障害が発生したノードで実行された仮想マシンでは、一連の条件によって次に起こる動作が変わります。潜在的な結果や、実行ストラテジーがそれらの結果にどのように影響するかに関する詳細は、「実行ストラテジー」のドキュメントを参照してください。

    現在、IBM Z® では installer-provisioned infrastructure はサポートされていません。

  • IPI と非 IPI の両方の自動高可用性は、OpenShift Container Platform クラスターで Node Health Check Operator を使用して NodeHealthCheck コントローラーをデプロイすることで利用できます。コントローラーは異常なノードを特定し、Self Node Remediation Operator や Fence Agents Remediation Operator などの修復プロバイダーを使用して異常なノードを修復します。ノードの修復、フェンシング、メンテナンスの詳細は、Red Hat OpenShift のワークロードの可用性 を参照してください。

    注記

    Fence Agents Remediation では、サポートされているフェンスエージェントを使用して、Self Node Remediation Operator よりも速く障害が発生したノードをリセットします。これにより、仮想マシン全体の高可用性が向上します。詳細は、ナレッジベース記事 OpenShift Virtualization - Fencing and VM High Availability Guide を参照してください。

  • モニタリングシステムまたは有資格者を使用してノードの可用性をモニターすることにより、あらゆるプラットフォームの高可用性を利用できます。ノードが失われた場合は、これをシャットダウンして oc delete node <lost_node> を実行します。

    注記

    外部モニタリングシステムまたは資格のある人材によるノードの正常性の監視が行われない場合、仮想マシンは高可用性を失います。

4.3. OpenShift Virtualization のインストール

OpenShift Virtualization をインストールし、仮想化機能を OpenShift Container Platform クラスターに追加します。

重要

インターネット接続のない制限された環境に OpenShift Virtualization をインストールする場合は、非接続環境用に Operator Lifecycle Manager (OLM) を設定する必要があります。

インターネット接続が制限されている場合は、OLM でプロキシーサポートを設定して、ソフトウェアカタログにアクセスできます。

4.3.1. OpenShift Virtualization のインストール方法

OpenShift Container Platform クラスターに OpenShift Virtualization をインストールするには、Operator Lifecycle Manager (OLM)、エージェントベースのインストール、または Assisted Installer を使用できます。

Operator Lifecycle Manager (OLM) を使用した標準インストール

OpenShift Container Platform の Web コンソールまたは CLI から OpenShift Virtualization Operator をインストールしてください。この方法はほとんどの導入シナリオに適しており、クラスター設定において最も高い柔軟性を提供します。

非接続環境の場合、OpenShift Virtualization をインストールする前に、制限付きネットワーク向けに OLM を設定する必要があります。

エージェントベースのインストール

Agent-based Installer を使用して、OpenShift Virtualization と関連オペレーターが事前に設定されたクラスターをデプロイします。このインストール方法は、特に非接続環境において、合理化された UI 主導のインストール体験を求めるユーザー向けに設計されています。

重要

エージェントベースのインストールは、テクノロジープレビュー機能としてのみ提供されています。テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は、実稼働環境でこれらを使用することを推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行い、フィードバックを提供していただくことを目的としています。

Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲 を参照してください。

仮想化バンドル付き Assisted Installer
Assisted Installer を使用して、OpenShift Virtualization および必要なサポートオペレーターを含む仮想化オペレーターバンドルを利用して、OpenShift Virtualization または Red Hat OpenShift Virtualization Engine をデプロイします。このインストール方法は、オペレーターを事前に設定し、外部依存関係を最小限に抑えることで、デプロイメントプロセスを簡素化します。これは、OpenShift Virtualization Engine の推奨インストール方法です。

4.3.1.1. インストール方法の選択

設置方法を選択する際には、以下の要素を考慮してください。

  • ネットワーク接続: ネットワークが切断された環境やエアギャップ環境では、Agent-based Installer、または仮想化バンドルを含む Assisted Installer を使用することで、レジストリーへの依存を減らし、デプロイメントを簡素化できます。
  • インストール手順:YAML ファイルを作成するよりも UI 主導のインストールワークフローを好む場合は、Agent-based Installer または Assisted Installer の使用を検討してください。
  • Operator の要件:Node Health Check Operator、Fence Agents Remediation Operator、NMStateOperator などの追加のオペレーターが必要な場合は、Assisted Installer 仮想化バンドルにこれらのオペレーターがデフォルトで含まれています。
  • カスタマイズの必要性: クラスター設定の柔軟性を最大限に高めるには、標準の OLM インストール方法を使用してください。

4.3.2. Web コンソールを使用した OpenShift Virtualization Operator のインストール

OpenShift Container Platform Web コンソールを使用して、OpenShift Virtualization Operator をデプロイできます。

前提条件

  • OpenShift Container Platform 4.21 がクラスターにインストールされている。
  • cluster-admin パーミッションを持つユーザーとして OpenShift Container Platform Web コンソールにログインしている。

手順

  1. Administrator パースペクティブから、Ecosystem Software Catalog をクリックします。
  2. Filter by keyword に Virtualization と入力します。
  3. Red Hat ソースラベルが示されている OpenShift Virtualization Operator タイルを選択します。
  4. Operator の情報を確認してから、Install をクリックします。
  5. Install Operator ページで以下を行います。

    1. 選択可能な Update Channel オプションの一覧から stable を選択します。これにより、OpenShift Container Platform バージョンと互換性がある OpenShift Virtualization のバージョンをインストールすることができます。
    2. インストールされた namespace の場合、Operator recommended namespace オプションが選択されていることを確認します。これにより、Operator が必須の openshift-cnv namespace にインストールされます。この namespace は存在しない場合は、自動的に作成されます。

      警告

      OpenShift Virtualization Operator を openshift-cnv 以外の namespace にインストールしようとすると、インストールが失敗します。

    3. Approval Strategy の場合に、stable 更新チャネルで新しいバージョンが利用可能になったときに OpenShift Virtualization が自動更新されるように、デフォルト値である Automatic を選択することを強く推奨します。

      Manual 承認ストラテジーを選択することは、クラスターのサポートと機能に大きなリスクをもたらすため、推奨しません。これらのリスクを完全に理解していて、Automatic を使用できない場合のみ、Manual を選択してください。

      警告

      OpenShift Virtualization は対応する OpenShift Container Platform バージョンで使用される場合にのみサポートされるため、OpenShift Virtualization が更新されないと、クラスターがサポートされなくなる可能性があります。

  6. Install をクリックし、Operator を openshift-cnv namespace で利用可能にします。
  7. Operator が正常にインストールされたら、Create HyperConverged をクリックします。
  8. オプション: OpenShift Virtualization コンポーネントの Infra および Workloads ノード配置オプションを設定します。
  9. Create をクリックして OpenShift Virtualization を起動します。

検証

  • Workloads Pods ページに移動して、OpenShift Virtualization Pod がすべて Running 状態になるまでこれらの Pod をモニターします。すべての Pod で Running 状態が表示された後に、OpenShift Virtualization を使用できます。

4.3.3. CLI を使用して OpenShift Virtualization カタログにサブスクライブします。

OpenShift Virtualization をインストールする前に、OpenShift Virtualization カタログにサブスクライブする必要があります。サブスクライブにより、openshift-cnv namespace に OpenShift Virtualization Operator へのアクセスが付与されます。

単一マニフェストをクラスターに適用して Namespace、OperatorGroup、および Subscription オブジェクトをサブスクライブし、設定します。

前提条件

  • クラスターに OpenShift Container Platform 4.21 がインストールされている。
  • OpenShift CLI (oc) がインストールされている。
  • cluster-admin 権限を持つユーザーとしてログインしている。

手順

  1. 以下のマニフェストを含む YAML ファイルを作成します。

    apiVersion: v1
    kind: Namespace
    metadata:
      name: openshift-cnv
      labels:
        openshift.io/cluster-monitoring: "true"
    ---
    apiVersion: operators.coreos.com/v1
    kind: OperatorGroup
    metadata:
      name: kubevirt-hyperconverged-group
      namespace: openshift-cnv
    spec:
      targetNamespaces:
        - openshift-cnv
    ---
    apiVersion: operators.coreos.com/v1alpha1
    kind: Subscription
    metadata:
      name: hco-operatorhub
      namespace: openshift-cnv
    spec:
      source: redhat-operators
      sourceNamespace: openshift-marketplace
      name: kubevirt-hyperconverged
      startingCSV: kubevirt-hyperconverged-operator.v4.21.24
      channel: "stable"

    stable チャネルを使用することで、OpenShift Container Platform バージョンと互換性のある OpenShift Virtualization のバージョンをインストールすることができます。

  2. 以下のコマンドを実行して、OpenShift Virtualization に必要な Namespace、OperatorGroup、および Subscription オブジェクトを作成します。

    $ oc apply -f <filename>.yaml

検証

OpenShift Virtualization のインストールに進む前に、サブスクリプションの作成が成功したことを確認する必要があります。

  1. ClusterServiceVersion (CSV) オブジェクトが正常に作成されたことを確認します。次のコマンドを実行し、出力を確認します。

    $ oc get csv -n openshift-cnv

    CSV が正常に作成された場合、次の出力例に示すように、出力には NAME 値が kubevirt-hyperconverged-operator-*、DISPLAY 値が OpenShift Virtualization、PHASE 値が Succeeded を含むエントリーが表示されます。

    出力例:

    NAME                                       DISPLAY                    VERSION   REPLACES                                   PHASE
    kubevirt-hyperconverged-operator.v4.21.24   OpenShift Virtualization   4.21.24    kubevirt-hyperconverged-operator.v4.20.0   Succeeded
  2. HyperConverged カスタムリソース (CR) のバージョンが正しいことを確認します。次のコマンドを実行し、出力を確認します。

    $ oc get hco -n openshift-cnv kubevirt-hyperconverged -o json | jq .status.versions

    出力例:

    {
    "name": "operator",
    "version": "4.21.24"
    }
  3. HyperConverged CR の条件を確認します。以下のコマンドを実行して出力を確認します。

    $ oc get hco kubevirt-hyperconverged -n openshift-cnv -o json | jq -r '.status.conditions[] | {type,status}'

    出力例:

    {
      "type": "ReconcileComplete",
      "status": "True"
    }
    {
      "type": "Available",
      "status": "True"
    }
    {
      "type": "Progressing",
      "status": "False"
    }
    {
      "type": "Degraded",
      "status": "False"
    }
    {
      "type": "Upgradeable",
      "status": "True"
    }

4.3.4. CLI を使用した OpenShift Virtualization Operator のデプロイ

oc CLI を使用して OpenShift Virtualization Operator をデプロイすることができます。

前提条件

  • OpenShift CLI (oc) がインストールされている。
  • cluster-admin 権限を持つユーザーとしてログインしている。
  • openshift-cnv namespace の OpenShift Virtualization カタログにサブスクライブしている。

手順

  1. 以下のマニフェストを含む YAML ファイルを作成します。

    apiVersion: hco.kubevirt.io/v1beta1
    kind: HyperConverged
    metadata:
      name: kubevirt-hyperconverged
      namespace: openshift-cnv
    spec:
  2. 以下のコマンドを実行して OpenShift Virtualization Operator をデプロイします。

    $ oc apply -f <file_name>.yaml

検証

  • openshift-cnv namespace の Cluster Service Version (CSV) の PHASE を監視して、OpenShift Virtualization が正常にデプロイされたことを確認します。以下のコマンドを実行します。

    $ watch oc get csv -n openshift-cnv

    以下の出力は、デプロイメントに成功したかどうかを表示します。

    NAME                                      DISPLAY                    VERSION   REPLACES   PHASE
    kubevirt-hyperconverged-operator.v4.21.24   OpenShift Virtualization   4.21.24                Succeeded

4.4. OpenShift Virtualization のアンインストール

Web コンソールまたはコマンドラインインターフェイス (CLI) を使用して OpenShift Virtualization をアンインストールし、OpenShift Virtualization のワークロード、Operator、およびそのリソースを削除できます。

OpenShift Virtualization をアンインストールするには、以下のタスクを実行します。

  1. HyperConverged CR を削除します。
  2. OpenShift Virtualization Operator を削除します。
  3. openshift-cnv namespace を削除します。
  4. OpenShift Virtualization カスタムリソース定義 (CRD) を削除します。

4.4.1. 前提条件

  • すべての仮想マシンインスタンスを削除します。ワークロードがクラスターに残っている間は、OpenShift Virtualization をアンインストールできません。

4.4.2. HyperConverged カスタムリソースの削除

OpenShift Virtualization をアンインストールするには、最初に HyperConverged カスタムリソース (CR) を削除します。

前提条件

  • cluster-admin パーミッションを持つアカウントを使用して OpenShift Container Platform クラスターにアクセスできる。

手順

  1. Ecosystem Installed Operators ページに移動します。
  2. OpenShift Virtualization Operator を選択します。
  3. OpenShift Virtualization Deployment タブをクリックします。
  4. kubevirt-hyperconverged の横にある Options メニュー kebab をクリックし、Delete HyperConverged を選択します。
  5. 確認ウィンドウで Delete をクリックします。

4.4.3. Web コンソールの使用によるクラスターからの Operator の削除

クラスター管理者は Web コンソールを使用して、選択した namespace からインストールされた Operators を削除できます。

警告

失敗した Operator のインストールでは、作成されたパーミッションが自動的に削除されません。namespace のセキュリティーを保護する残りのパーミッションを監査および削除します。

詳細は、Audit and secure delegated Operator installations (Red Hat ナレッジベース) を参照してください。

前提条件

  • cluster-admin 権限を持つアカウントを使用して OpenShift Container Platform クラスター Web コンソールにアクセスできる。

手順

  1. Ecosystem Installed Operators ページに移動します。
  2. スクロールするか、キーワードを Filter by name フィールドに入力して、削除する Operator を見つけます。次に、それをクリックします。
  3. Operator Details ページの右側で、Actions 一覧から Uninstall Operator を選択します。

    Uninstall Operator? ダイアログボックスが表示されます。

  4. Uninstall を選択し、Operator、Operator デプロイメント、および Pod を削除します。このアクションの後には、Operator は実行を停止し、更新を受信しなくなります。

    注記

    このアクションは、カスタムリソース定義 (CRD) およびカスタムリソース (CR) など、Operator が管理するリソースは削除されません。Web コンソールおよび継続して実行されるクラスター外のリソースによって有効にされるダッシュボードおよびナビゲーションアイテムには、手動でのクリーンアップが必要になる場合があります。Operator のアンインストール後にこれらを削除するには、Operator CRD を手動で削除する必要があります。

4.4.4. Web コンソールを使用した namespace の削除

OpenShift Container Platform Web コンソールを使用して namespace を削除できます。

前提条件

  • cluster-admin パーミッションを持つアカウントを使用して OpenShift Container Platform クラスターにアクセスできる。

手順

  1. Administration Namespaces に移動します。
  2. namespace のリストで削除する必要のある namespace を見つけます。
  3. namespace のリストの右端で、Options メニュー kebab から Delete Namespace を選択します。
  4. Delete Namespace ペインが表示されたら、フィールドから削除する namespace の名前を入力します。
  5. Delete をクリックします。

4.4.5. OpenShift Virtualization カスタムリソース定義の削除

Web コンソールを使用して、OpenShift Virtualization カスタムリソース定義 (CRD) を削除できます。

前提条件

  • cluster-admin パーミッションを持つアカウントを使用して OpenShift Container Platform クラスターにアクセスできる。

手順

  1. Administration CustomResourceDefinitions に移動します。
  2. Label フィルターを選択し、Search フィールドに operators.coreos.com/kubevirt-hyperconverged.openshift-cnv と入力して OpenShift Virtualization CRD を表示します。
  3. 各 CRD の横にある Options メニュー kebab をクリックし、Delete CustomResourceDefinition の削除を選択します。

4.4.6. CLI を使用した OpenShift Virtualization のアンインストール

OpenShift CLI (oc) を使用して OpenShift Virtualization をアンインストールできます。

前提条件

  • cluster-admin パーミッションを持つアカウントを使用して OpenShift Container Platform クラスターにアクセスできる。
  • OpenShift CLI (oc) がインストールされている。
  • すべての仮想マシンと仮想マシンインスタンスを削除した。ワークロードがクラスターに残っている間は、OpenShift Virtualization をアンインストールできません。

手順

  1. HyperConverged カスタムリソースを削除します。

    $ oc delete HyperConverged kubevirt-hyperconverged -n openshift-cnv
  2. OpenShift Virtualization Operator サブスクリプションを削除します。

    $ oc delete subscription hco-operatorhub -n openshift-cnv
  3. OpenShift Virtualization ClusterServiceVersion リソースを削除します。

    $ oc delete csv -n openshift-cnv -l operators.coreos.com/kubevirt-hyperconverged.openshift-cnv
  4. OpenShift Virtualization namespace を削除します。

    $ oc delete namespace openshift-cnv
  5. dry-run オプションを指定して oc delete crd コマンドを実行し、OpenShift Virtualization カスタムリソース定義 (CRD) を一覧表示します。

    $ oc delete crd --dry-run=client -l operators.coreos.com/kubevirt-hyperconverged.openshift-cnv

    出力例:

    customresourcedefinition.apiextensions.k8s.io "cdis.cdi.kubevirt.io" deleted (dry run)
    customresourcedefinition.apiextensions.k8s.io "hostpathprovisioners.hostpathprovisioner.kubevirt.io" deleted (dry run)
    customresourcedefinition.apiextensions.k8s.io "hyperconvergeds.hco.kubevirt.io" deleted (dry run)
    customresourcedefinition.apiextensions.k8s.io "kubevirts.kubevirt.io" deleted (dry run)
    customresourcedefinition.apiextensions.k8s.io "networkaddonsconfigs.networkaddonsoperator.network.kubevirt.io" deleted (dry run)
    customresourcedefinition.apiextensions.k8s.io "ssps.ssp.kubevirt.io" deleted (dry run)
    customresourcedefinition.apiextensions.k8s.io "tektontasks.tektontasks.kubevirt.io" deleted (dry run)
  6. dry-run オプションを指定せずに oc delete crd コマンドを実行して、CRD を削除します。

    $ oc delete crd -l operators.coreos.com/kubevirt-hyperconverged.openshift-cnv

4.5. IBM Cloud ベアメタルノードへの OpenShift Virtualization のインストール

Assisted Installer を使用して、IBM Cloud ベアメタルノードに OpenShift Virtualization をインストールします。このクラスターは、6 つのベアメタルノード (コントロール 3 つ、コンピュート 3 つ) で設定されています。ブートストラップ用のほか、Samba サーバー、DHCP サーバー、ネットワークゲートウェイ、ロードバランサーとして機能させるために、追加の仮想マシンが 1 台必要です。

4.5.1. 前提条件

  • ベアメタルノードの注文および運用権限を持つ IBM Cloud アカウントがある。
  • IBM Cloud SSL VPN ユーザーである (ノードの SuperMicro IPMI インターフェイスにアクセスするために使用)。
  • OpenShift CLI (oc) がインストールされている。

4.5.2. 新しいクラスター向けに IBM Cloud を設定する

IBM Cloud 環境を設定およびプロビジョニングして、OpenShift Virtualization クラスターの運用フレームワークとノードを確立します。

手順

  1. IBM Cloud の Virtual Server for Classic に、踏み台サーバーとなる新しい仮想サーバーインスタンスを作成します。このインスタンスは、インストールを実行し、環境サービスを提供するために使用されます。
  2. 新しい仮想サーバーインスタンスのデフォルトプロパティーを以下の値に変更します。その他の値については、提供されているデフォルト値を使用します。

    • Type of virtual server: Public
    • Operating system: CentOS
    • お使いの公開 SSH RSA キー
  3. VLANs で、仮想サーバーインスタンスが割り当てられているプライベート VLAN とサブネットを確認します。
  4. Bare metal server provision から、IBM Cloud 上に 6 つのベアメタルノードをプロビジョニングします。ノードをプロビジョニングする際は、以下の値を使用します。

    • Domain: レコードを追加できるサブドメイン。
    • Quantity: 6
    • Location: 仮想サーバーインスタンスと同じ場所。
    • Storage disks: RAID 1
    • Network Interface: Private
    • Private VLAN: 仮想サーバーインスタンスで指定したものと同じ。
  5. デバイスリスト で、すべてのノードがプロビジョニングされ、準備完了状態であることを確認します。
  6. コントロールプレーンノードの名前を control0-<domain-name>、control1-<domain-name>、および control2-<domain-name> に変更します。<domain-name> は、ノードのプロビジョニング時に使用したドメイン名に置き換えます。
  7. コンピュートノードの名前を compute0-<domain-name>、compute1-<domain-name>、および compute2-<domain-name> に変更します。<domain-name> は、ノードのプロビジョニング時に使用したドメイン名に置き換えます。
  8. 踏み台仮想サーバーインスタンスをデフォルトのネットワークゲートウェイとして設定します。
  9. 踏み台仮想サーバーインスタンス上の /etc/dhcp/dhcpd.conf を編集して、DHCP を設定します。以下に例を示します。

    # Set DNS name and DNS server's IP address or hostname
    option domain-name  <dns_domain_name>;
    option domain-name-servers  <dns_ip_addresses>;
    
    # Declare DHCP Server
    authoritative;
    
    # The default DHCP lease time
    default-lease-time <default_lease_value>;
    
    # Set the maximum lease time
    max-lease-time <max_lease_value>;
    
    # Set Network address, subnet mask and gateway
    
    subnet <subnet_ip_address> netmask <subnet_mask> {
      # Range of IP addresses to allocate
      range dynamic-bootp <dynamic_boot_lower_address> <dynamic_boot_upper_address>;
      # Provide broadcast address
      option broadcast-address <broadcast_ip_address>;
      # Set default gateway
      option routers <default_gateway_ip_address>;

    各項目の説明:

    <dns_domain_name>
    DNS クライアントのデフォルトドメイン名を指定します。
    <dns_ip_addresses>
    DNS サーバーの IP アドレスをコンマ区切りで指定します。
    <default_lease_value>
    クライアントが割り当てられたアドレスを保持するデフォルトの秒数を指定します。
    <max_lease_value>
    クライアントが割り当てられたアドレスを保持する最大秒数を指定します。
    <subnet_ip_address>
    サブネット IP アドレス範囲の開始を指定します。
    <subnet_mask>
    サブネット IP アドレス範囲のサブネットマスクを指定します。
    <broad_ip_address>
    サブネット上のすべてのデバイスにメッセージを送信する場合に使用するブロードキャスト IP アドレスを指定します。
    <default_gateway_ip_address>
    サブネットのデフォルトゲートウェイを指定します。
  10. 踏み台仮想サーバーインスタンスで DHCP を再起動します。

    $ systemctl restart dhcpd
  11. 踏み台仮想サーバーインスタンスで IP フォワーディングを有効にします。

    $ sysctl -w net.ipv4.ip_forward=1
  12. 踏み台仮想サーバーインスタンスで IP フォワーディングが有効化されていることを確認します。

    $ sysctl -p /etc/sysctl.conf
  13. 踏み台仮想サーバーインスタンス上のネットワークサービスを再起動します。

    $ service network restart
  14. 踏み台仮想サーバーインスタンスで firewalld が有効化されているか確認します。

    $ firewall-cmd --state
  15. 踏み台仮想サーバーインスタンスで firewalld サービスが有効化されていない場合は、サービスを有効化します。

    $ systemctl enable firewalld
  16. firewalld サービスを開始します。

    $ systemctl start firewalld
  17. firewalld サービスにネットワークアドレス変換 (NAT) ルールを追加します。

    $ firewall-cmd --add-masquerade --permanent
  18. firewalld サービスを再起動します。

    $ firewall-cmd --reload

4.5.3. 新しいクラスター設定を初期化します。

踏み台仮想サーバーインスタンス上で、OpenShift Virtualization の Assisted Installer サービスと Samba を使用して、新しいクラスター設定を初期化します。

手順

  1. Assisted Installer サービスにログインします。
  2. 新規クラスターを作成します。新しいクラスターは以下の特性を備えています。

    • クラスター名: ベースドメイン下のクラスターを識別するために使用される名前。
    • ベースドメイン: ベアメタルノードをプロビジョニングするために使用されるドメイン。
  3. Next をクリックします。
  4. Generate Discovery ISO をクリックします。
  5. プロンプトが表示されたら、公開 SSH RSA キーを入力します。
  6. ISO ファイル用に生成された wget コマンドをコピーして保存します。これは後でクラスターノードに接続するために使用されます。
  7. 踏み台仮想サーバーインスタンスに Samba サーバーをインストールします。

    $ dnf install samba
  8. 踏み台仮想サーバーインスタンスで Samba サーバーを有効化します。

    $ systemctl enable smb --now
  9. Samba サーバーの NAT ルールを設定します。

    $ firewall-cmd --permanent --zone=FedoraWorkstation --add-service=samba
    $ firewall-cmd --reload
  10. root ユーザーのパスワードを設定します。

    $ sudo smbpasswd -a root
  11. 共有ディレクトリーを作成します。

    $ mkdir <share_directory>

    <share_directory> は、共有ディレクトリー名に置き換えます。

  12. 共有ディレクトリーに移動し、生成された wget コマンドを使用して Assisted Installer ISO ファイルをダウンロードします。

4.5.4. クラスターネットワークおよびアクセスの設定

クラスターのリモート管理を可能にするために、ネットワークとアクセスを設定します。

手順

  1. /etc/samba/smb.conf を編集して、以下の設定を使用します。

    [global]
          log level = 3
              workgroup = SAMBA
              security = user
    
              passdb backend = tdbsam
    
              printing = cups
              printcap name = cups
              load printers = yes
              cups options = raw
    
          server min protocol = NT1
          ntlm auth = yes
    
    [share]
          comment = ISO Files
          path = /root/share
          browseable = yes
          public = no
          read only = no
          directory mode = 0555
          valid users = root
    注記

    smb.conf ファイルのより詳細な例については、同じディレクトリーにある smb.conf.example ファイルを参照してください。

  2. ファイルを保存します。
  3. 新しい Samba の設定を確認します。

    $ testparm
  4. Samba サービスを再起動します。

    $ systemctl restart smb
  5. Samba サービスが実行され、アクティブであることを確認します。

    $ systemctl status smb
  6. IBM Cloud への SSL VPN アクセスを設定します。

    1. IBM Cloud ドキュメントの Getting started with IBM Cloud Virtual Private Networking の手順を実行します。
    2. MotionPro SSL VPN クライアントをダウンロードしてインストールします。
    3. 適切な IBM Cloud エンドポイントに接続します。

      $ sudo MotionPro --host $<vpn_endpoint> --user $<vpn_username> --passwd $<vpn_password>

      各項目の説明:

      <vpn_endpoint>
      適切な SSL VPN エンドポイントを指定します。
      <vpn_username>
      設定した SSL VPN ユーザー名を指定します。
      <vpn_password>

      設定した SSL VPN パスワードを指定します。

      注記

      IBM Cloud SSL VPN に接続すると、開いている VPN 接続はすべて切断されます。

4.5.5. クラスター設定を完了する

コントロールプレーンノードとコンピュートノードにソフトウェアをインストールし、外部アクセス用の DNS を設定することで、クラスター設定を完了します。

手順

  1. 各ベアメタルサーバーに対して、以下のタスクを実行します。

    1. IPMI コンソールを使用してサーバーにアクセスします。

      注記

      IPMI コンソールへのアクセスに必要な IP アドレスと認証情報は、各サーバーの リモート管理 セクションに記載されています。

    2. 以下の属性を使用して、Assisted Installer ISO ファイルをマウントします。

      • Virtual Media: CD-ROM イメージ
      • Share host: 踏み台サーバーのプライベート IP アドレス。
      • Path to image: Assisted Installer ISO ファイルの場所。
      • User: root
      • Password: 設定した root ユーザーパスワード。
    3. Save and Mount をクリックします。
    4. ISO ファイルが正常にマウントされたことを確認します。
    5. Remote Control Power Control Reset Server Perform Action を選択してサーバーを再起動します。
  2. Assisted Installer サービスに戻ります。
  3. Assisted Installer オプションの Install OpenShift Virtualization および Install OpenShift Data Foundation のチェックボックスを選択します。
  4. 各ホストにロールを選択します。

    注記

    このクラスターは、3 つのコントロールプレーンノードと 3 つのコンピュートノードで構成されています。

  5. Assisted Installer インターフェイスが各ノードの準備完了を示すまで待機します。
  6. Next をクリックします。
  7. Cluster Managed Network を選択します。
  8. DHCP から取得する場合は、API VIP と Ingress VIP のチェックボックスを選択し、静的な値を入力する場合はチェックを外したままにします。
  9. Install をクリックします。
  10. 各ベアメタルサーバーに対して、以下のタスクを実行します。

    1. IPMI コンソールを使用してサーバーにアクセスします。

      注記

      IPMI コンソールへのアクセスに必要な IP アドレスと認証情報は、各サーバーの リモート管理 セクションに記載されています。

    2. Virtual Media CD-Rom Image を選択します。
    3. Unmount をクリックします。
    4. Remote Control Power Control Reset Server Perform Action を選択して、サーバーを再起動します。
  11. インストール概要の Cluster Credentials セクションを探します。
  12. Cluster Credentials セクションで、以下のタスクを実行します。

    1. kubeconfig ファイルをダウンロードします。
    2. kubeadmin のパスワードを保存します。
  13. 踏み台仮想サーバーインスタンスに haproxy をインストールします。
  14. お使いの環境に合わせて haproxy を設定します。以下に設定例を示します。

    #---------------------------------------------------------------------
    # Example configuration for a possible web application.  See the
    # full configuration options online.
    #
    #   https://www.haproxy.org/download/1.8/doc/configuration.txt
    #
    #---------------------------------------------------------------------
    
    #---------------------------------------------------------------------
    # Global settings
    #---------------------------------------------------------------------
    global
      # to have these messages end up in /var/log/haproxy.log you will
      # need to:
      #
      # 1) configure syslog to accept network log events.  This is done
      # by adding the '-r' option to the SYSLOGD_OPTIONS in
      # /etc/sysconfig/syslog
      #
      # 2) configure local2 events to go to the /var/log/haproxy.log
      #   file. A line like the following can be added to
      #   /etc/sysconfig/syslog
      #
      # local2.*                    /var/log/haproxy.log
      #
      log       127.0.0.1 local2
    
      chroot    /var/lib/haproxy
      pidfile   /var/run/haproxy.pid
      maxconn   4000
      user      haproxy
      group     haproxy
      daemon
    
      # turn on stats unix socket
      stats socket /var/lib/haproxy/stats
    
      # utilize system-wide crypto-policies
      #ssl-default-bind-ciphers PROFILE=SYSTEM
      #ssl-default-server-ciphers PROFILE=SYSTEM
    
    #---------------------------------------------------------------------
    # common defaults that all the 'listen' and 'backend' sections will
    # use if not designated in their block
    #---------------------------------------------------------------------
    defaults
      mode                  tcp
      log                   global
      option                httplog
      option                dontlognull
      option http-server-close
      option forwardfor     except 127.0.0.0/8
      option                redispatch
      retries               3
      timeout http-request  10s
      timeout queue         1m
      timeout connect       10s
      timeout client        1m
      timeout server        1m
      timeout http-keep-alive 10s
      timeout check         10s
      maxconn               3000
    #---------------------------------------------------------------------
    # main frontend which proxys to the backends
    #---------------------------------------------------------------------
    
    frontend api
      bind <api_ip_address>:<api_port>
      default_backend controlplaneapi
    
    frontend apiinternal
      bind <apiinternal_ip_address>:<apiinternal_port>
      default_backend controlplaneapiinternal
    
    frontend secure
      bind <frontend_secure_ip_address>:<frontend_secure_port>
      default_backend secure
    
    frontend insecure
      bind <frontend_insecure_ip_address>:<frontend_insecure_port>
      default_backend insecure
    
    #---------------------------------------------------------------------
    # static backend
    #---------------------------------------------------------------------
    
    backend controlplaneapi
      balance source
      server api <controlplaneapi_ip_address>:<controlplaneapi_port> check
    
    backend controlplaneapiinternal
      balance source
      server api <controlplaneapiinternal_ip_address>:<controlplaneapiinternal_port> check
    
    backend secure
      balance source
      server ingress <backend_secure_ip_address>:<backend_secure_port> check
    
    backend insecure
      balance source
      server ingress <backend_insecure_ip_address>:<backend_insecure_port> check

    各項目の説明:

    <api_ip_address>:<api_port>
    Kubernetes API サーバーが使用するフロントエンドの IP アドレスとポートを指定します。
    <apiinternal_ip_address>:<apiinternal_port>
    内部クラスター管理に使用されるフロントエンドの IP アドレスとポートを指定します。
    <frontend_secure_ip_address>:<frontend_secure_port>
    ホスト型アプリケーションの HTTPS トラフィックに使用されるフロントエンドの IP アドレスとポートを指定します。
    <frontend_insecure_ip_address>:<frontend_insecure_port>
    ホスト型アプリケーションの HTTP トラフィックに使用されるフロントエンドの IP アドレスとポートを指定します。
    <controlplaneapi_ip_address>:<controlplaneapi_port>
    Kubernetes API サーバーが使用するバックエンドの IP アドレスとポートを指定します。
    <controlplaneapiinternal_ip_address>:<controlplaneapiinternal_port>
    内部クラスター管理に使用されるバックエンドの IP アドレスとポートを指定します。
    <backend_secure_ip_address>:<backend_secure_port>
    ホスト型アプリケーションの HTTPS トラフィックに使用されるバックエンド IP アドレスとポートを指定します。
    <backend_insecure_ip_address>:<backend_insecure_port>

    ホスト型アプリケーションの HTTP トラフィックに使用されるバックエンド IP アドレスとポートを指定します。

    注記

    サンプル値は、ご使用のネットワーク設定に適した値に置き換えます。

  15. haproxy の設定を保存します。
  16. サブドメインに対して、インターネット経由で外部からアクセス可能な 2 つの DNS アドレスレコード (A レコード) を設定します。

    <bastion_public_ip_address> api.<cluster_name>.<cluster_domain>
    <bastion_public_ip_address> *.apps..<cluster_name>.<cluster_domain>

    各項目の説明:

    <bastion_public_ip_address>
    踏み台仮想サーバーインスタンスの外部から利用可能な IP アドレスを指定します。
    <cluster_name>
    クラスターに割り当てられた名前を指定します。
    <cluster_domain>
    クラスターに割り当てられたドメインを指定します。

検証

  1. コマンドラインアクセスを使用してクラスターへのアクセスを確認するには、以下のタスクを実行します。

    1. kubeconfig ファイルを使用して環境を設定します。

      $ export KUBECONFIG=<kubeconfig_file_path>

      各項目の説明:

      <kubeconfig_file_path>
      ダウンロードした kubeconfig ファイルへのパスを指定します。
    2. クラスターノードの状態を確認します。

      $ oc get nodes
      注記

      コマンド出力の STATUS 列にはすべてのノードが Ready と表示され、ROLES 列にはコントロールプレーンノードとコンピュートノードが存在することが表示されるはずです。

    3. クラスターバージョンを確認します。

      $ oc get clusterversion
      注記

      コマンドの出力には Condition: Available と表示されるはずです。

  2. Web コンソールを使用してクラスターへのアクセスを確認するには、以下の手順を実行します。

    1. Assisted Installer から提供されたアクセス URL を Web ブラウザーに貼り付けます。

      注記

      デフォルトでは、クラスターは自己署名証明書を使用します。これにより、ブラウザーに Connection not private といったメッセージ、または同様の警告が表示される場合があります。この警告を閉じ、続行します。

    2. URL に移動します。
    3. Cluster Credentials セクションに記載されているユーザー名 kubeadmin とパスワード kubeadmin を使用してクラスターにログインします。
Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

Red Hat ドキュメントについて

Legal Notice

Theme

© 2026 Red Hat
トップに戻る