仮想化

手順

1. Web コンソールの Virtualization → Overview ページに移動します。
2. Download virtctl リンクをクリックして、オペレーティングシステム用の virtctl バイナリーをダウンロードします。

3. virtctl をインストールします。

   • RHEL 9 およびその他の Linux オペレーティングシステムの場合:

     1. アーカイブファイルを解凍します。

        $ tar -xvf <virtctl-version-distribution.arch>.tar.gz

        Copy to Clipboard Toggle word wrap

     2. 次のコマンドを実行して、virtctl バイナリーを実行可能にします。

        $ chmod +x <path/virtctl-file-name>

        Copy to Clipboard Toggle word wrap

     3. virtctl バイナリーを PATH 環境変数 にあるディレクトリーに移動します。

        次のコマンドを実行して、パスを確認できます。

        $ echo $PATH

        Copy to Clipboard Toggle word wrap

     4. KUBECONFIG 環境変数を設定します。

        $ export KUBECONFIG=/home/<user>/clusters/current/auth/kubeconfig

        Copy to Clipboard Toggle word wrap

   • Windows の場合:

     1. アーカイブファイルを展開します。
     2. 展開したフォルダー階層に移動し、virtctl 実行可能ファイルをダブルクリックしてクライアントをインストールします。

     3. virtctl バイナリーを PATH 環境変数 にあるディレクトリーに移動します。

        次のコマンドを実行して、パスを確認できます。

        C:\> path

        Copy to Clipboard Toggle word wrap

   • macOS の場合:

     1. アーカイブファイルを展開します。

     2. virtctl バイナリーを PATH 環境変数 にあるディレクトリーに移動します。

        次のコマンドを実行して、パスを確認できます。

        echo $PATH

        Copy to Clipboard Toggle word wrap

手順

1. subscription-manager CLI ツールを使用して次のコマンドを実行し、OpenShift Virtualization リポジトリーを有効にします。

   # subscription-manager repos --enable cnv-4.19-for-rhel-8-x86_64-rpms

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行して、kubevirt-virtctl パッケージをインストールします。

   # yum install kubevirt-virtctl

   Copy to Clipboard Toggle word wrap

手順

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

5. Install Operator ページで以下を行います。

   1. 選択可能な Update Channel オプションの一覧から stable を選択します。これにより、Red Hat OpenShift Service on AWS のバージョンと互換性のある 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 は、対応する Red Hat OpenShift Service on AWS バージョンで使用される場合にのみサポートされるため、OpenShift Virtualization の更新が欠落していると、クラスターがサポートされなくなる可能性があります。

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

手順

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

手順

1. Operators → 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 を手動で削除する必要があります。

手順

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

手順

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

手順

1. Web コンソールで、Networking → NetworkAttachmentDefinitions をクリックします。

2. Create Network Attachment Definition をクリックします。

   注記

   Network Attachment Definition は Pod または仮想マシンと同じ namespace にある必要があります。

3. 一意の Name およびオプションの Description を入力します。
4. Network Type リストから CNV Linux bridge を選択します。
5. Bridge Name フィールドにブリッジの名前を入力します。

6. オプション: リソースに VLAN ID が設定されている場合、VLAN Tag Number フィールドに ID 番号を入力します。

   注記

   IBM Z® 上の OSA インターフェイスは VLAN フィルタリングをサポートしていないため、VLAN タグ付きのトラフィックは破棄されます。OSA インターフェイスでは VLAN タグを使用する NAD を使用しないでください。

7. オプション: MAC Spoof Check を選択して、MAC スプーフフィルタリングを有効にします。この機能により、Pod を終了するための MAC アドレスを 1 つだけ許可することで、MAC スプーフィング攻撃に対してセキュリティーを確保します。
8. Create をクリックします。

手順

1. 次の例に従って、NetworkAttachmentDefinition マニフェストを作成します。

   設定ファイルのサンプル

   apiVersion: "k8s.cni.cncf.io/v1"
   kind: NetworkAttachmentDefinition
   metadata:
     name: my-secondary-network 

   1

   
     namespace: openshift-cnv
   spec:
     config: '{
       "cniVersion": "0.3.1",
       "name": "migration-bridge",
       "type": "macvlan",
       "master": "eth1", 

   2

   
       "mode": "bridge",
       "ipam": {
         "type": "whereabouts", 

   3

   
         "range": "10.200.5.0/24" 

   4

   
       }
     }'

   Copy to Clipboard Toggle word wrap

   1

   NetworkAttachmentDefinition オブジェクトの名前を指定します。

   2

   ライブマイグレーションに使用する NIC の名前を指定します。

   3

   NAD にネットワークを提供する CNI プラグインの名前を指定します。

   4

   セカンダリーネットワークの IP アドレス範囲を指定します。この範囲は、メインネットワークの IP アドレスと重複してはなりません。

2. 以下のコマンドを実行して、デフォルトのエディターで HyperConverged CR を開きます。

   $ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv

   Copy to Clipboard Toggle word wrap

3. NetworkAttachmentDefinition オブジェクトの名前を HyperConverged CR の spec.liveMigrationConfig スタンザに追加します。

   HyperConverged マニフェストの例

   apiVersion: hco.kubevirt.io/v1beta1
   kind: HyperConverged
   metadata:
     name: kubevirt-hyperconverged
     namespace: openshift-cnv
   spec:
     liveMigrationConfig:
       completionTimeoutPerGiB: 800
       network: <network> 

   1

   
       parallelMigrationsPerCluster: 5
       parallelOutboundMigrationsPerNode: 2
       progressTimeout: 150
   # ...

   Copy to Clipboard Toggle word wrap

   1

   ライブマイグレーションに使用される Multus NetworkAttachmentDefinition オブジェクトの名前を指定します。

4. 変更を保存し、エディターを終了します。virt-handler Pod が再起動し、セカンダリーネットワークに接続されます。

手順

1. Red Hat OpenShift Service on AWS Web コンソールで Virtualization > Overview に移動します。
2. Settings タブをクリックし、Live migration をクリックします。
3. Live migration network リストからネットワークを選択します。

手順

1. storageclass_csi.yaml ファイルを作成して、ストレージクラスを定義します。

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: hostpath-csi
   provisioner: kubevirt.io.hostpath-provisioner
   reclaimPolicy: Delete 

   1

   
   volumeBindingMode: WaitForFirstConsumer 

   2

   
   parameters:
     storagePool: my-storage-pool 

   3

   Copy to Clipboard Toggle word wrap

   1

   reclaimPolicy には、Delete および Retain の 2 つの値があります。値を指定しない場合、デフォルト値は Delete です。

   2

   volumeBindingMode パラメーターは、動的プロビジョニングとボリュームのバインディングが実行されるタイミングを決定します。WaitForFirstConsumer を指定して、永続ボリューム要求 (PVC) を使用する Pod が作成されるまで PV のバインディングおよびプロビジョニングを遅延させます。これにより、PV が Pod のスケジュール要件を満たすようになります。

   3

   HPP CR で定義されているストレージプールの名前を指定します。

2. ファイルを保存して終了します。

3. 次のコマンドを実行して、StorageClass オブジェクトを作成します。

   $ oc create -f storageclass_csi.yaml

   Copy to Clipboard Toggle word wrap

手順

1. デフォルトエディターで HyperConverged CR を作成するには、以下のコマンドを実行します。

   $ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv

   Copy to Clipboard Toggle word wrap

2. HyperConverged CR の workloadUpdateStrategy スタンザを編集します。以下に例を示します。

   apiVersion: hco.kubevirt.io/v1beta1
   kind: HyperConverged
   metadata:
     name: kubevirt-hyperconverged
   spec:
     workloadUpdateStrategy:
       workloadUpdateMethods: 

   1

   
       - LiveMigrate 

   2

   
       - Evict 

   3

   
       batchEvictionSize: 10 

   4

   
       batchEvictionInterval: "1m0s" 

   5

   
   # ...

   Copy to Clipboard Toggle word wrap

   1

   ワークロードの自動更新を実行するのに使用できるメソッド。設定可能な値は LiveMigrate および Evict です。上記の例のように両方のオプションを有効にした場合に、ライブマイグレーションをサポートする VMI には LiveMigrate を、ライブマイグレーションをサポートしない VMI には Evict を、更新に使用します。ワークロードの自動更新を無効にするには、workloadUpdateStrategy スタンザを削除するか、workloadUpdateMethods: [] を設定して配列を空のままにします。

   2

   中断を最小限に抑えた更新メソッド。ライブマイグレーションをサポートする VMI は、仮想マシン (VM) ゲストを更新されたコンポーネントが有効なっている新規 Pod に移行することで更新されます。LiveMigrate がリストされている唯一のワークロード更新メソッドである場合には、ライブマイグレーションをサポートしない VMI は中断または更新されません。

   3

   アップグレード時に VMI Pod をシャットダウンする破壊的な方法。Evict は、ライブマイグレーションがクラスターで有効でない場合に利用可能な唯一の更新方法です。VMI が runStrategy: Always に設定された VirtualMachine オブジェクトによって制御される場合には、新規の VMI は、更新されたコンポーネントを使用して新規 Pod に作成されます。

   4

   Evict メソッドを使用して一度に強制的に更新できる VMI の数。これは、LiveMigrate メソッドには適用されません。

   5

   次のワークロードバッチをエビクトするまで待機する間隔。これは、LiveMigrate メソッドには適用されません。

   注記

   HyperConverged CR の spec.liveMigrationConfig スタンザを編集することにより、ライブマイグレーションの制限とタイムアウトを設定できます。

3. 変更を適用するには、エディターを保存し、終了します。

手順

1. Operators → Installed Operators をクリックします。
2. リストから OpenShift Virtualization を選択します。
3. Subscription タブをクリックします。
4. Subscription details セクションで、変更する設定をクリックします。たとえば、承認ストラテジーを Manual から Automatic に変更するには、Manual をクリックします。
5. 開いたウィンドウで、新しい更新チャネルまたは承認ストラテジーを選択します。
6. Save をクリックします。

手順

1. Red Hat OpenShift Service on AWS Web コンソールの Administrator パースペクティブで、Operators → Installed Operators に移動します。
2. 更新が保留中の Operator は Upgrade available のステータスを表示します。更新する Operator の名前をクリックします。
3. Subscription タブをクリックします。承認が必要な更新は、Upgrade status の横に表示されます。たとえば、1 requires approval が表示される可能性があります。
4. 1 requires approval をクリックしてから、Preview Install Plan をクリックします。
5. 更新に利用可能なリソースとして一覧表示されているリソースを確認します。問題がなければ、Approve をクリックします。
6. Operators → Installed Operators ページに戻り、更新の進捗をモニターします。完了時に、ステータスは Succeeded および Up to date に変更されます。