OpenShift 仮想化アドオンの管理
仮想プライベートクラウド 4.21 そしてその後 ベアメタルのワーカーノードのみ RHCOSのみ
「 openshift-virtualization 」アドオンを使用すると、 OpenShift Virtualization Service クラスター上で、ワンクリックで仮想化プラットフォームをセットアップできます。 このアドオンは、すべての仮想化サービスクラスターで、デフォルトで自動的に有効になっています。
OpenShift の仮想化アドオンについて
OpenShift の仮想化アドオンは、Virtualization Serviceクラスターで仮想マシン機能を利用できるようにするため、以下のオペレーターの展開と管理を調整します
- OpenShift 仮想化オペレーター(ハイパーコンバージド)
- 仮想マシンの実行および管理に必要な中核的な仮想化機能を提供します。 詳細については、「 OpenShift 仮想化のインストール 」を参照してください。
- NMStateオペレーター
- 仮想マシンおよびノードのネットワーク設定を管理します。 詳細については、 「 Kubernetes NMState オペレーターについて」を参照してください。
- Node 保守オペレーター
- 仮想マシンのワークロードに対するノードのメンテナンス操作を処理します。 詳細については、「 Node メンテナンスオペレーター 」を参照してください。
Red Hat ( OperatorHub )からこれらのオペレーターをインストールすることは、Virtualization Service クラスターではブロックされています。 このアドオンは、すべてのオペレーターのインストールと更新を管理します。
アドオンの特徴
OpenShift の仮想化アドオンには、以下の特徴があります:
- 自動有効化
- 仮想化サービスクラスターを作成すると、このアドオンは自動的に有効になります。 CLI やコンソールから手動でアドオンを有効にすることはできません。
- 無効にすることはできません
- このアドオンの無効化はサポートされていません。 コンソールではこのオプションは利用できず、CLI を通じて無効にしようとするとエラーが発生します。
- 設定オプションはありません
- このアドオンには、ユーザーが設定可能なパラメータはありません。
- バージョンのバインディング
- アドオン版は、仮想化サービスクラスタのバージョン(例: 4.21 )に紐付けられています。 このアドオンは、現在のマイナーバージョンおよび次のマイナーバージョン( n+1 )に対応しています。 たとえば、アドオン版 4.21 は、Virtualization Serviceのバージョン 4.21 および 4.22 と組み合わせて使用できます。
- パッチの自動更新
- 「 自動承認 」戦略を使用すると、パッチの更新がクラスターに自動的に適用されます。 IBM 変更内容の詳細について、本番環境への展開の少なくとも1週間前にお知らせします。 ミラーリングされたオペレーターカタログに新しいバージョンが存在する場合、依存するすべてのオペレーターが自動的に更新されます。 このアドオンは、すべてのオペレーターの更新に
stableチャンネルを使用します。 - 手動によるバージョンアップ
- アドオンを新しいバージョンにアップグレードするには(たとえば、 4.20 から 4.21 へ)、まず Virtualization Service クラスターを対象バージョンにアップグレードし、その後、CLI コマンド
ibmcloud ks cluster addon update openshift-virtualization --cluster CLUSTER_NAME_OR_ID --version VERSION`` を使用してアドオンのバージョンを手動で更新する必要があります。 - チャネルの更新
- このアドオンは、バグ修正やセキュリティ問題に対するZ-streamアップデートを提供する「
stable」チャンネルを利用して更新を行います。 - バージョンの互換性
- 各アドオンバージョンは、現在の仮想化サービスバージョン(n)および次のマイナーバージョン( n+1 )に対応しています。 たとえば、アドオンバージョン 4.20 は、Virtualization Serviceのバージョン 4.20 および 4.21 に対応しています。
- カスタム・カタログ
- 依存関係のある演算子がミラーリングされたカスタムカタログは、アドオンの有効化時に自動的に設定され、
openshift-marketplaceネームスペースに配置されます。
インストール済みリソース
アドオンを有効にすると、以下のリソースが作成されます:
- 親オペレーターの名前空間
ibm-openshift-virt-operatorネームスペースには、親オペレーターに関連するすべてのリソースが含まれており、これにはibmopenshiftvirtualizations.openshiftvirt.ibm.io`` 型のカスタムリソースも含まれます。- カスタム・カタログ
- カスタムカタログは、
openshift-marketplace名前空間に配置されます。 - 従属演算子
- 親演算子はメタ演算子として機能し、調整処理中に以下の従属演算子をインストールします:
- OpenShift 仮想化(
openshift-cnv名前空間内) - NMState(
openshift-nmstate名前空間内) - Node 保守オペレーター(
openshift-operators名前空間内)
- OpenShift 仮想化(
アドオンの情報を表示する
アカウントこの機能フラグが有効になっている場合、CLI を使用して「 OpenShift Virtualization」アドオンに関する情報を確認できます。 機能フラグが有効になっていない場合は、代わりにコンソールとクラスタの詳細情報を使用して、アドオンのステータスを確認してください。
インストール済みのアドオンの一覧
Virtualization Service クラスタにインストールされているすべてのアドオンを一覧表示します。
ibmcloud ks cluster addon ls --cluster CLUSTER_NAME_OR_ID
出力例:
Name Version Health State Health Status
ibm-storage-operator 1.0 normal Addon Ready. For more info: http://ibm.biz/addon-state (H1500)
openshift-virtualization 4.21 normal Addon Ready. For more info: http://ibm.biz/addon-state (H1500)
アドオンの詳細を確認する
お使いのアカウントこの機能フラグが有効になっている場合は、「 OpenShift 仮想化アドオン」に関する詳細情報をご確認ください。
ibmcloud ks cluster addon get --addon openshift-virtualization --cluster CLUSTER_NAME_OR_ID
出力例:
name: openshift-virtualization
Version: 4.21
Health State: normal
Health Status: Addon Ready. For more info: http://ibm.biz/addon-state (H1500)
利用可能なアドオンバージョンの一覧
アカウント機能フラグが有効になっている場合、 OpenShift 仮想化アドオンの利用可能なバージョンを一覧表示します。
ibmcloud ks cluster addon versions --addon openshift-virtualization
出力例:
Name Version Supported Kubernetes Range Supported OpenShift Range Kubernetes Default OpenShift Default
openshift-virtualization 4.19 unsupported >=4.19.0 <4.21.0 - >=4.19.0 <4.21.0
openshift-virtualization 4.21 unsupported >=4.21.0 <4.23.0 - >=4.21.0 <4.23.0
この出力には、各アドオンバージョンでサポートされている仮想化サービスのバージョンが表示されています。
設定オプションの確認
お使いのアカウントこの機能フラグが有効になっている場合、「 OpenShift Virtualization」アドオンには設定オプションがないことを確認できます。
ibmcloud ks cluster addon options --addon openshift-virtualization
出力例:
FAILED
No addon installation options are available for openshift-virtualization.
アドオンの更新
OpenShift の仮想化アドオンでは、2種類の更新がサポートされています:
パッチの自動更新
パッチの更新(例: 4.21.1 から 4.21.2 への更新など)は、すべてのクラスタに自動的に適用されます。 これらの更新には、バグ修正とセキュリティパッチが含まれています。 IBM 本番環境へのパッチ更新の適用に先立ち、少なくとも1週間前に通知を行う。
自動パッチ更新プロセスでは、以下の処理が行われます:
- 親オペレータを再起動します
- カタログのソースを照合します
stableチャンネルの購読状況に基づいて、すべての子オペレーターを更新します
手動によるバージョンアップ
OpenShift の仮想化アドオンを新しいマイナーバージョン(たとえば、 4.20 から 4.21 へ)にアップグレードするには、まず仮想化サービスクラスタを対象バージョンにアップグレードする必要があります。 お使いのアカウントでこの機能フラグが有効になっていない場合は、CLIの更新を行う前に、 IBM サポートまでお問い合わせください。
-
仮想化サービスクラスタを目標バージョンにアップグレードしてください。 詳細については、「 クラスタの更新 」を参照してください。
-
クラスタのアップグレードが完了したら、アドオンを対応するバージョンに更新してください。
ibmcloud ks cluster addon update openshift-virtualization --cluster CLUSTER_NAME_OR_ID --version VERSIONたとえば、バージョン 4.21:
ibmcloud ks cluster addon update openshift-virtualization --cluster my-rovs-cluster --version 4.21
互換性とサポートを最適化するため、クラスタのバージョンに合わせてアドオンのバージョンを更新することを強くお勧めします。
アドオンの無効化
OpenShift の仮想化アドオンの無効化は、Virtualization Serviceクラスター(フェーズ1)ではサポートされていません。 このアドオンは仮想化サービスの主要な構成要素であり、削除することはできません。 お使いのアカウントでこの機能フラグが有効になっている場合、CLIコマンドを実行するとエラーが発生します。
ibmcloud ks cluster addon disable openshift-virtualization --cluster CLUSTER_NAME_OR_ID
フェーズ2では、標準的なROKSクラスターにおけるアドオンのアンインストール機能の提供を予定しています。
アドオンのトラブルシューティング
「 OpenShift 」仮想化アドオンで問題が発生した場合は、サポートケースを開く前に、以下の情報をまとめておいてください。
アドオン情報の収集
OpenShift 仮想化アドオンおよびその依存オペレーターに関する詳細情報を収集するには、以下のコマンドを実行してください。
-
IBM の「 OpenShift 」仮想化カスタムリソースを入手してください。
oc get ibmopenshiftvirtualizations.openshiftvirt.ibm.io -n ibm-openshift-virt-operator -o yaml -
親オペレータネームスペース内のすべてのリソースを一覧表示します。
oc get all -n ibm-openshift-virt-operator -
OpenShift の仮想化オペレーターのステータスを確認してください。
oc get csv -n openshift-cnv -
HyperConverged のリソース詳細を確認する。
oc get hco -n openshift-cnv kubevirt-hyperconverged -o yaml -
「 OpenShift Virtualization」ネームスペース内のすべてのリソースを一覧表示します。
oc get all -n openshift-cnv -
NMStateのオペレーターのステータスを確認してください。
oc get csv -n openshift-nmstate -
NMState 名前空間内のすべてのリソースを一覧表示します。
oc get all -n openshift-nmstate -
NMStateのリソース詳細を確認する。
oc get nmstate nmstate -o yaml -
NodeNetworkConfigurationPolicy のリソースを一覧表示します。
oc get nncp -
Node のメンテナンスオペレーターのステータスを確認してください。
oc get csv -n openshift-operators -
operators ネームスペース内のすべてのリソースを一覧表示します。
oc get all -n openshift-operators -
カスタムカタログのソースを確認してください。
oc get catalogsource custom-redhat-operators-openshiftvirt -n openshift-marketplace -
カスタムカタログのパッケージマニフェストを一覧表示します。
oc get packagemanifests -n openshift-marketplace | grep "Custom Redhat Operators for Openshift Virtualization"
サポート・ケースをオープンする
問題が解決しない場合は、サポートチケットを作成し、トラブルシューティングコマンドの実行結果を添付してください。 詳しくは、サポートの利用を参照してください。