OpenShift 仮想化オペレータのインストール

仮想プライベートクラウド 4.17 そしてその後 ベアメタルのワーカーノードのみ RHCOSのみ

クラスタ用のストレージを設定した後、 OpenShift Virtualization Operatorをインストールして仮想マシン管理機能を有効にします。

OpenShift 仮想化サービスには オペレーターがプリインストールされているため、手動でのインストールは不要です。 OpenShift 仮想化サービス クラスタには、「 OpenShift Virtualization」、「NMState」、および「 Node Maintenance」オペレーターがプリインストールされており、「 openshift-virtualization 」アドオンによって管理されます。 このページは、 OpenShift Virtualizationを手動でインストールした標準の OpenShift クラスタにのみ適用されます。

開始前に

OpenShift Virtualization Operator をインストールする前に、以下の手順を完了してください:

  1. 以下の要件で Red Hat OpenShift on IBM Cloud クラスターを作成 します:

    • ベアメタルワーカーノード :仮想化ワークロードに必要
    • RHCOSオペレーティング・システム :必須(RHELは不可)
    • OVN- Kubernetes CNI :高度なネットワーク機能に必要
    • OpenShift 4.20 またはそれ以降 :完全な仮想化サポートに必要
    • アウトバウンド・トラフィックの保護 :無効にする必要がある(クラスタ作成時に設定することも、作成後に無効にすることもできる)

    クラスタ作成時にUIまたはCLIで送信トラフィック保護を無効にするか、クラスタ作成後に手順3のコマンドを使用して無効にすることができます。

  2. OpenShift 仮想化用のストレージをセットアップする。 クラスタには、正しく構成されたストレージ・ソリューション(ODFまたはVPC File Storage )が1つだけ必要です。

  3. クラスタ作成時に送信トラフィックの保護を無効にしていない場合は、今すぐ無効にしてください。

    ibmcloud oc vpc outbound-traffic-protection disable -c CLUSTER_NAME
    

    この手順が必要なのは、クラスタ作成時にアウトバウンド・トラフィック保護が無効になっていない場合のみです。

  4. デフォルトのカタログソースを有効にする。

    ibmcloud ks cluster config --admin -c CLUSTER_NAME
    oc patch operatorhub cluster --type json -p '[{"op": "add", "path": "/spec/disableAllDefaultSources", "value": false}]'
    
  5. カタログソースが利用可能であることを確認する。

    oc get catalogsource -n openshift-marketplace
    
  6. OpenShift 仮想化パッケージが利用可能であることを確認する。

    oc get packagemanifests -n openshift-marketplace | grep kubevirt
    

コンソールからの OpenShift 仮想化オペレータのインストール

  1. IBM Cloud コンソールにログインし、クラスタに移動します。

  2. OpenShift コンソールを開くには、 OpenShift ウェブコンソールをクリックします。

  3. OpenShift コンソールで、 Ecosystem > (または Operators >) に移動します。 OperatorHub (以前のバージョンでは Operators > OperatorHub に移動します。)

  4. OpenShift 仮想化を検索する。

  5. OpenShift Virtualization タイルをクリックし、 Install をクリックします。

  6. 「オペレーターのインストール」ページで、以下の設定を行います

    • チャンネルを更新します: OpenShift バージョンの適切なチャンネルを選択してください
    • インストールモード :クラスタ上のすべてのネームスペース(デフォルト)
    • インストールされた名前空間: openshift-cnv(デフォルト)
    • アップデートの承認自動(推奨)
  7. **「インストール」**をクリックしてインストールを開始します。

  8. オペレーターのインストールが完了するまでお待ちください。 準備ができると、ステータスは Succeededに変わる。

CLI からの OpenShift 仮想化オペレータのインストール

  1. 「 OpenShift 」仮想化オペレーター用の名前空間を作成します。
    oc create namespace openshift-cnv
    
  2. OperatorGroup を作成します。
    cat <<EOF | oc apply -f -
    apiVersion: operators.coreos.com/v1
    kind: OperatorGroup
    metadata:
      name: kubevirt-hyperconverged-group
      namespace: openshift-cnv
    spec:
      targetNamespaces:
      - openshift-cnv
    EOF
    
  3. オペレータをインストールするサブスクリプションを作成します。
    cat <<EOF | oc apply -f -
    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.20.8
      channel: "stable"
    EOF
    
  4. オペレーターの設置を確認する。
    oc get csv -n openshift-cnv
    
    PHASE 列に Succeeded と表示されるまで待つ。

HyperConverged のカスタムリソースの作成

オペレータがインストールされたら、 HyperConverged カスタムリソースを作成し、 OpenShift 仮想化コンポーネントを展開します。

ノードの配置を理解する

Red Hat OpenShift on IBM Cloud クラスタには、 master というラベルの付いたノードはない。 ノード配置ポリシーを構成して、仮想化コンポーネントと VM ワークロードの実行場所を指定する必要があります。

コンソールから HyperConverged CR を作成する

  1. OpenShift、コンソールで「 Ecosystem > Installed Operators 」(以前のバージョンでは 「Operators > Installed Operators」 )に移動します。

  2. OpenShift Virtualizationをクリックする。

  3. [ HyperConverged タブをクリックしてください。

  4. Create HyperConverged をクリックします。

  5. インフラストラクチャ・コンポーネントのノード配置を構成する:

    • インフラ 」タブをクリック
    • ターゲットVSIノードにノードセレクタまたはトレランスを追加する
  6. VM ワークロード用にノード配置を構成する:

    • ワークロード タブをクリック
    • ベアメタルノードをターゲットとするノードセレクタまたはトレランスの追加
  7. 「作成」 をクリックします。

CLIから HyperConverged CRを作成する

HyperConverged カスタムリソースをデフォルト設定で作成します。

cat <<EOF | oc apply -f -
apiVersion: hco.kubevirt.io/v1beta1
kind: HyperConverged
metadata:
  name: kubevirt-hyperconverged
  namespace: openshift-cnv
spec:
EOF

インストールの検証

  1. HyperConverged リソースのステータスをチェックする。

    oc get hyperconverged -n openshift-cnv
    

    PHASE 列に Deployed と表示されるまで待つ。

  2. 仮想化ポッドが実行されていることを確認してください。

    oc get pods -n openshift-cnv
    
  3. OpenShift コンソールで仮想化メニューを確認する。

    • OpenShift コンソールにログインしてください
    • メインナビゲーションメニューで「 仮想化 」を探す
  4. ストレージプロファイルが作成されていることを確認する。

    oc get storageprofile
    
  5. VPC File Storage を使用する場合は、 「OpenShift 仮想化用のストレージの設定 」の説明に従ってストレージプロファイルを設定します。

インストール問題のトラブルシューティング

HyperConverged リソースの展開に失敗

HyperConverged リソースがノード配置エラーでデプロイに失敗した場合:

  1. ノードのラベルを確認してください。
    oc get nodes --show-labels
    
  2. HyperConverged CRを正しいノードセレクタで更新する。
    oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv
    
  3. HyperConverged オペレーターのログを確認する。
    oc logs -n openshift-cnv -l name=hyperconverged-cluster-operator
    

オペレーターのインストールに失敗

オペレーターのインストールに失敗した場合:

  1. カタログソースが有効になっていることを確認する。
    oc get catalogsource -n openshift-marketplace
    
  2. オペレーターの加入状況を確認します。
    oc get subscription -n openshift-cnv
    
  3. オペレーターのログを確認する。
    oc logs -n openshift-cnv -l app=kubevirt-hyperconverged-operator
    

次のステップ

OpenShift 仮想化をインストールした後:

完全なインストール手順については、 Red Hat ドキュメントの「 OpenShift 仮想化のインストール 」を参照してください。