第6章 オプション: Operator のインストールおよび設定
Assisted Installer は、UI または API のいずれかで、デフォルト設定で選択した Operator をインストールできます。高度なオプションが必要な場合は、クラスターのインストール後に目的の Operator をインストールします。
Assisted Installer は、選択された Operator のインストールをクラスターインストールの一部として監視して、ステータスを報告します。インストール中に 1 つ以上の Operator でエラーが発生した場合、Assisted Installer はクラスターのインストールが完了したことを報告する際に、1 つ以上の Operator がインストールに失敗したことを警告します。
Assisted Installer の UI または API を使用して、クラスター定義をインストールまたは変更するときに設定できる Operator については、以下のセクションを参照してください。OpenShift Container Platform クラスターの完全なインストール手順は、Assisted Installer UI を使用したインストール または Assisted Installer API を使用したインストール をそれぞれ参照してください。
6.1. Operator のインストール
Assisted Installer UI を使用して Operator をインストールする場合は、ウィザードの Operators ページで Operator を選択します。Assisted Installer API を使用して Operator をインストールする場合は、/v2/clusters エンドポイントで POST メソッドを使用します。
6.1.1. OpenShift virtualization のインストール
クラスターを設定するときに、OpenShift Virtualization を有効にすることができます。
現在、OpenShift Virtualization は IBM zSystems および IBM Power ではサポートされていません。
有効な場合、Assisted Installer は次のことを行います。
- 環境が以下に概説する前提条件を満たしていることを検証します。
仮想マシンストレージを次のように設定します。
- 単一ノードの OpenShift クラスターバージョン 4.10 以降の場合、自動インストーラーは hostpath provisioner を設定します。
- 以前のバージョンの単一ノード OpenShift クラスターの場合、Assisted Installer は Local Storage Operator を設定します。
- マルチノードクラスターの場合、Assisted Installer は OpenShift Data Foundation を設定します。
前提条件
- Red Hat Enterprise Linux (RHEL) 8 でサポート
- Intel 64 または AMD64 CPU 拡張機能のサポート
- Intel Virtualization Technology または AMD-V ハードウェア仮想化拡張機能が有効
- NX (実行なし) フラグが有効
手順
Assisted Installer UI を使用している場合:
- ウィザードの Operator の手順で、Install OpenShift Virtualization のチェックボックスを有効にします。
Assisted Installer API を使用している場合:
新規クラスターを登録する際に、
"olm_operators: [{"name": "cnv"}]"
ステートメントを追加します。注記CNV は container-native Virtualization の略です。
以下に例を示します。
$ curl -s -X POST https://api.openshift.com/api/assisted-install/v2/clusters \ -H "Authorization: Bearer ${API_TOKEN}" \ -H "Content-Type: application/json" \ -d "$(jq --null-input \ --slurpfile pull_secret ~/Downloads/pull-secret.txt ' { "name": "testcluster", "openshift_version": "4.11", "cpu_architecture" : "x86_64", "base_dns_domain": "example.com", "olm_operators: [{"name": "cnv"}]" "pull_secret": $pull_secret[0] | tojson } ')" | jq '.id'
関連情報
- OpenShift Virtualization 用にクラスターを準備する方法の詳細については、OpenShift ドキュメント を参照してください。
6.1.2. Multicluster Engine (MCE) のインストール
クラスターを設定するときに、Multicluster Engine (MCE) Operator を有効にすることができます。Multicluster Engine (MCE) Operator を使用すると、現在インストールしているクラスターから追加のクラスターをインストールできます。
前提条件
- OpenShift バージョン 4.10 以降である。
- マルチノード OpenShift クラスター用に追加の 4 CPU コアと 16 GB の RAM がある。
- シングルノード OpenShift クラスター用に追加の 8 CPU コアと 32GB RAM がある。
ストレージに関する考慮事項
インストールの前に、Multicluster Engine からデプロイメントされるクラスターの管理に必要なストレージを考慮する必要があります。ストレージを自動化するには、次のいずれかのシナリオを選択できます。
- OpenShift Data Foundation (ODF) をマルチノードクラスターにインストールします。ODF はクラスターに推奨されるストレージですが、追加のサブスクリプションが必要です。詳細は、この章の OpenShift Data Foundation のインストール を参照してください。
- 論理ボリューム管理ストレージ (LVMS) を単一ノード OpenShift (SNO) クラスターにインストールします。
- ストレージを設定せずに Multicluster Engine をマルチノードクラスターにインストールします。次に、選択したストレージを設定し、インストール後に Central Infrastructure Management (CIM) サービスを有効にします。詳細は、この章の 関連情報 を参照してください。
手順
Assisted Installer UI を使用している場合:
- ウィザードの Operators ステップで、Install multicluster engine チェックボックスを有効にします。
Assisted Installer API を使用している場合:
新しいクラスターを登録するときは、
"olm_operators: [{"name": "mce"}]"
ステートメントを使用します。以下に例を示します。$ curl -s -X POST https://api.openshift.com/api/assisted-install/v2/clusters \ -H "Authorization: Bearer ${API_TOKEN}" \ -H "Content-Type: application/json" \ -d "$(jq --null-input \ --slurpfile pull_secret ~/Downloads/pull-secret.txt ' { "name": "testcluster", "openshift_version": "4.11", "cpu_architecture" : "x86_64" "base_dns_domain": "example.com", "olm_operators: [{"name": "mce"}]", "pull_secret": $pull_secret[0] | tojson } ')" | jq '.id'
インストール後の手順
- Multicluster Engine で Assisted Installer テクノロジーを使用するには、Central Infrastructure Management サービスを有効にします。詳細は、Central Infrastructure Management サービスの有効化 を参照してください。
- ホスト型コントロールプレーンを使用して OpenShift Container Platform クラスターをデプロイするには、ホスト型コントロールプレーンを設定します。詳細は、ホスト型コントロールプレーン を参照してください。
関連情報
- Multicluster Engine (MCE) Operator に関連する Advanced Cluster Management のドキュメントは、Red Hat Advanced Cluster Management for Kubernetes を参照してください。
- Multicluster Engine (MCE) Operator に関連する OpenShift Container Platform のドキュメントは、Multicluster Engine for Kubernetes Operator を参照してください。
6.1.3. OpenShift Data Foundation のインストール
クラスターを設定するときに、OpenShift Data Foundation を有効にすることができます。有効な場合、Assisted Installer は次のことを行います。
- 環境が以下に概説する前提条件を満たしていることを検証します。ディスクデバイスが再フォーマットされていることを検証しません。これは、起動する前に確認する必要があります。
- 使用可能なすべてのディスクを使用するようにストレージを設定します。
OpenShift Data Foundation を有効にすると、Assisted Installer は、OpenShift Data Foundation で使用できるすべてのディスクを指定する StorageCluster
リソースを作成します。別の設定が必要な場合は、クラスターのインストール後に設定を変更するか、クラスターのインストール後に Operator をインストールします。
前提条件
- クラスターが 3 ノードの OpenShift クラスターであるか、少なくとも 3 つのワーカーノードがある。
- 各ホストには、少なくとも 25 GB の非インストールディスクが少なくとも 1 つあります。
- 使用しているディスクデバイスは空でなければなりません。物理ボリューム (PV)、ボリュームグループ (VG)、または論理ボリューム (LV) がディスク上に残っていないはずです。
- 各ホストには、他の CPU 要件に加えて、3 ノード OpenShift の場合は 6 つの CPU コア、または標準クラスターの場合は 8 つの CPU コアがあります。
- 各ホストには、他の RAM 要件に加えて、19 GiB RAM があります。
- 各ホストには、他の CPU と RAM の要件に加えて、ストレージディスクごとに 2 つの CPU コアと 5GiB RAM があります。
- 各ホストにコントロールプレーンまたはワーカーのロールを割り当てました (自動割り当てではありません)。
手順
Assisted Installer UI を使用している場合:
- ウィザードの Operators の手順で、Install OpenShift Data Foundation のチェックボックスを有効にします。
Assisted Installer API を使用している場合:
新しいクラスターを登録する場合は、
"olm_operators: [{"name": "odf"}]"
ステートメントを追加します。以下に例を示します。$ curl -s -X POST https://api.openshift.com/api/assisted-install/v2/clusters \ -H "Authorization: Bearer ${API_TOKEN}" \ -H "Content-Type: application/json" \ -d "$(jq --null-input \ --slurpfile pull_secret ~/Downloads/pull-secret.txt ' { "name": "testcluster", "openshift_version": "4.11", "cpu_architecture" : "x86_64", "base_dns_domain": "example.com", "olm_operators: [{"name": "odf"}]", "pull_secret": $pull_secret[0] | tojson } ')" | jq '.id'
関連情報
- OpenShift Data Foundation の詳細については、OpenShift ドキュメント を参照してください。
6.1.4. 論理ボリュームマネージャーストレージのインストール
クラスターを設定する際に、単一ノードの OpenShift クラスターで論理ボリュームマネージャーストレージ(LVMS) Operator を有効にすることができます。LVMS Operator をインストールすると、ローカルストレージを動的にプロビジョニングできます。
前提条件
- バージョン 4.11 以降にインストールされた単一ノードの OpenShift クラスター
- 少なくとも 1 つの非インストールディスク
- 1 つの追加の CPU コアおよび 400 MB の RAM (1200 MB の RAM は 4.13 より前のバージョンの場合)
手順
Assisted Installer UI を使用している場合:
- ウィザードの Operator ステップで、Install Logical Volume Manager Storage チェックボックスを有効にします。
Assisted Installer API を使用している場合:
新規クラスターを登録する場合は、
olm_operators: [{"name": "lvm"}]
ステートメントを使用します。以下に例を示します。$ curl -s -X POST https://api.openshift.com/api/assisted-install/v2/clusters \ -H "Authorization: Bearer ${API_TOKEN}" \ -H "Content-Type: application/json" \ -d "$(jq --null-input \ --slurpfile pull_secret ~/Downloads/pull-secret.txt ' { "name": "testcluster", "openshift_version": "4.14", "cpu_architecture" : "x86_64", "base_dns_domain": "example.com", "olm_operators: [{"name": "lvm"}]" "pull_secret": $pull_secret[0] | tojson } ')" | jq '.id'
関連情報
- LVMS に関連する OpenShift Container Platform ドキュメントについては、LVM ストレージを使用した永続ストレージ を参照して ください。