手順

1. Administrator パースペクティブから、Operators → OperatorHub をクリックします。
2. Filter by keyword フィールドに OpenShift Virtualization を入力します。
3. OpenShift Virtualization タイルを選択します。
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 を起動します。

手順

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

   apiVersion: v1
   kind: Namespace
   metadata:
     name: openshift-cnv
   ---
   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.12.1
     channel: "stable" 1

   1

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

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

   $ oc apply -f <file name>.yaml

手順

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

手順

1. OpenShift Container Platform Web コンソールで Virtualization > Overview に移動します。
2. ページの右上隅にある Download virtctl リンクをクリックして、お使いのオペレーティングシステム用の virtctl クライアントをダウンロードします。

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

   • Linux の場合

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

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

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

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

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

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

        $ echo $PATH

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

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

   • Windows の場合:

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

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

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

        C:\> path

   • MacOS の場合:

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

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

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

        echo $PATH

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

手順

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

   $ oc delete HyperConverged kubevirt-hyperconverged -n openshift-cnv

2. OpenShift Virtualization Operator サブスクリプションを削除します。

   $ oc delete subscription kubevirt-hyperconverged -n openshift-cnv

3. OpenShift Virtualization ClusterServiceVersion リソースを削除します。

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

4. 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)

5. dry-run オプションを指定せずに oc delete crd コマンドを実行して、CRD を削除します。

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

手順

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

手順

1. 以下のコマンドを実行します。

   $ oc get csv -n openshift-cnv

2. 出力を確認し、PHASE フィールドをチェックします。以下に例を示します。

   出力例

   VERSION  REPLACES                                        PHASE
   4.9.0    kubevirt-hyperconverged-operator.v4.8.2         Installing
   4.9.0    kubevirt-hyperconverged-operator.v4.9.0         Replacing

3. オプション: 以下のコマンドを実行して、すべての OpenShift Virtualization コンポーネントの状態の集約されたステータスをモニターします。

   $ oc get hco -n openshift-cnv kubevirt-hyperconverged \
   -o=jsonpath='{range .status.conditions[*]}{.type}{"\t"}{.status}{"\t"}{.message}{"\n"}{end}'

   アップグレードが成功すると、以下の出力が得られます。

   出力例

   ReconcileComplete  True  Reconcile completed successfully
   Available          True  Reconcile completed successfully
   Progressing        False Reconcile completed successfully
   Degraded           False Reconcile completed successfully
   Upgradeable        True  Reconcile completed successfully

手順

1. Web コンソールで、Help メニューから Quick Starts を選択します。
2. Quick Starts カタログのタイルをクリックします。例: Red Hat Linux Enterprise Linux 仮想マシンの作成
3. ガイド付きツアーの手順に従い、オペレーティングシステムイメージのインポートと仮想マシンの作成タスクを実行します。Virtualization → VirtualMachines ページに仮想マシンが表示されます。

手順

1. サイドメニューの Virtualization → Catalog をクリックします。

2. 利用可能なブートソース をクリックして、テンプレートをブートソースでフィルターリングします。

   注記

   デフォルトでは、テンプレートリストには Default Templates のみが表示されます。選択したフィルターで使用可能なすべてのテンプレートを表示するには、フィルターリング時に すべてのアイテムをクリックします。

3. テンプレートをクリックして詳細を表示します。

4. 仮想マシンのクイック作成をクリックして、テンプレートから VM を作成します。

   仮想マシンの詳細ページに、プロビジョニングステータスが表示されます。

検証

1. Events をクリックして、仮想マシンがプロビジョニングされたときにイベントのストリームを表示します。
2. Console をクリックして、仮想マシンが正常に起動したことを確認します。

手順

1. Web コンソールで、テンプレートを選択します。

   1. サイドメニューの Virtualization → Catalog をクリックします。
   2. オプション: プロジェクト、キーワード、オペレーティングシステム、またはワークロードプロファイルでテンプレートをフィルター処理します。
   3. カスタマイズするテンプレートをクリックします。
2. Customize VirtualMachineを クリックします。
3. Name や Disk source など、仮想マシンのパラメーターを指定します。オプションで、複製するデータソースを指定できます。

検証

1. Events をクリックして、仮想マシンがプロビジョニングされたときにイベントのストリームを表示します。
2. Console をクリックして、仮想マシンが正常に起動したことを確認します。

手順

1. 仮想マシンの VirtualMachine マニフェストを編集します。たとえば、次のマニフェストは Red Hat Enterprise Linux (RHEL) 仮想マシンを設定します。

   例10.1 RHEL 仮想マシンのマニフェストの例

   apiVersion: kubevirt.io/v1
   kind: VirtualMachine
   metadata:
     labels:
       app: <vm_name> 1
     name: <vm_name>
   spec:
     dataVolumeTemplates:
     - apiVersion: cdi.kubevirt.io/v1beta1
       kind: DataVolume
       metadata:
         name: <vm_name>
       spec:
         sourceRef:
           kind: DataSource
           name: rhel9
           namespace: openshift-virtualization-os-images
         storage:
           resources:
             requests:
               storage: 30Gi
     running: false
     template:
       metadata:
         labels:
           kubevirt.io/domain: <vm_name>
       spec:
         domain:
           cpu:
             cores: 1
             sockets: 2
             threads: 1
           devices:
             disks:
             - disk:
                 bus: virtio
               name: rootdisk
             - disk:
                 bus: virtio
               name: cloudinitdisk
             interfaces:
             - masquerade: {}
               name: default
             rng: {}
           features:
             smm:
               enabled: true
           firmware:
             bootloader:
               efi: {}
           resources:
             requests:
               memory: 8Gi
         evictionStrategy: LiveMigrate
         networks:
         - name: default
           pod: {}
         volumes:
         - dataVolume:
             name: <vm_name>
           name: rootdisk
         - cloudInitNoCloud:
             userData: |-
               #cloud-config
               user: cloud-user
               password: '<password>' 2
               chpasswd: { expire: False }
           name: cloudinitdisk

   1

   仮想マシンの名前を指定します。

   2

   cloud-user のパスワードを指定します。

2. マニフェストファイルを使用して仮想マシンを作成します。

   $ oc create -f <vm_manifest_file>.yaml

3. オプション: 仮想マシンを開始します。

   $ virtctl start <vm_name>

手順

1. Web コンソールで Virtualization → VirtualMachines に移動します。
2. 仮想マシンを選択して、VirtualMachine details ページを開きます。
3. フィールドが編集可能であることを示す鉛筆アイコンが付いているフィールドをクリックします。たとえば、BIOS や UEFI などの現在の ブートモード 設定をクリックして、Boot mode ウィンドウを開き、リストからオプションを選択します。
4. Save をクリックします。

手順

1. サイドメニューから Virtualization → VirtualMachines をクリックします。
2. 仮想マシンを選択します。
3. YAML タブをクリックして編集可能な設定を表示します。
4. オプション: Download をクリックして YAML ファイルをその現在の状態でローカルにダウンロードできます。
5. ファイルを編集し、Save をクリックします。

手順

1. 以下のコマンドを実行して、仮想マシン設定を更新します。

   $ oc edit <object_type> <object_ID>

2. オブジェクト設定を開きます。
3. YAML を編集します。

4. 実行中の仮想マシンを編集する場合は、以下のいずれかを実行する必要があります。

   • 仮想マシンを再起動します。

   • 新規の設定を有効にするために、以下のコマンドを実行します。

     $ oc apply <object_type> <object_ID>

手順

1. サイドメニューから Virtualization → VirtualMachines をクリックします。
2. 仮想マシンを選択して、VirtualMachine details 画面を開きます。
3. Disks タブをクリックし、Add disk をクリックします。

4. Add disk ウィンドウで、Source、Name、Size、Type、Interface、および Storage Class を指定します。

   1. オプション: 空のディスクソースを使用し、データボリュームの作成時に最大の書き込みパフォーマンスが必要な場合に、事前割り当てを有効にできます。そのためには、Enable preallocation チェックボックスをオンにします。
   2. オプション: Apply optimized StorageProfile settings をクリアして、仮想ディスクの Volume Mode と Access Mode を変更できます。これらのパラメーターを指定しない場合、システムは kubevirt-storage-class-defaults config map のデフォルト値を使用します。
5. Add をクリックします。

手順

1. サイドメニューから Virtualization → VirtualMachines をクリックします。
2. 仮想マシンを選択して、VirtualMachine details 画面を開きます。
3. Network Interfaces タブをクリックします。
4. Add Network Interface をクリックします。
5. Add Network Interface ウィンドウで、ネットワークインターフェイスの Name、Model、Network、 Type、および MAC Address を指定します。
6. Add をクリックします。

手順

1. サイドメニューから Virtualization → VirtualMachines をクリックします。
2. 仮想マシンを選択して、VirtualMachine details ページを開きます。
3. Details タブをクリックします。
4. Boot Order の右側にある鉛筆アイコンをクリックします。YAML 設定が存在しない場合や、これがブート順序一覧の初回作成時の場合、以下のメッセージが表示されます。No resource selected.仮想マシンは、YAML ファイルでの出現順にディスクからの起動を試行します。
5. Add Source をクリックして、仮想マシンのブート可能なディスクまたはネットワークインターフェイスコントローラー (NIC) を選択します。
6. 追加のディスクまたは NIC をブート順序一覧に追加します。
7. Save をクリックします。

手順

1. サイドメニューから Virtualization → VirtualMachines をクリックします。
2. 仮想マシンを選択して、VirtualMachine details ページを開きます。
3. Details タブをクリックします。
4. Boot Order の右側にある鉛筆アイコンをクリックします。

5. ブート順序一覧で項目を移動するのに適した方法を選択します。

   • スクリーンリーダーを使用しない場合、移動する項目の横にある矢印アイコンにカーソルを合わせ、項目を上下にドラッグし、選択した場所にドロップします。
   • スクリーンリーダーを使用する場合は、上矢印キーまたは下矢印を押して、ブート順序一覧で項目を移動します。次に Tab キーを押して、選択した場所に項目をドロップします。
6. Save をクリックします。

手順

1. 以下のコマンドを実行して、仮想マシンの YAML 設定ファイルを開きます。

   $ oc edit vm example

2. YAML ファイルを編集し、ディスクまたはネットワークインターフェイスコントローラー (NIC) に関連付けられたブート順序の値を変更します。以下に例を示します。

   disks:
     - bootOrder: 1 1
       disk:
         bus: virtio
       name: containerdisk
     - disk:
         bus: virtio
       name: cloudinitdisk
     - cdrom:
         bus: virtio
       name: cd-drive-1
   interfaces:
     - boot Order: 2 2
       macAddress: '02:96:c4:00:00'
       masquerade: {}
       name: default

   1

   ディスクに指定されたブート順序の値。

   2

   ネットワークインターフェイスコントローラーに指定されたブート順序の値。

3. YAML ファイルを保存します。
4. reload the content をクリックして、Web コンソールで YAML ファイルの更新されたブート順序の値をブート順序一覧に適用します。

手順

1. サイドメニューから Virtualization → VirtualMachines をクリックします。
2. 仮想マシンを選択して、VirtualMachine details ページを開きます。
3. Details タブをクリックします。
4. Boot Order の右側にある鉛筆アイコンをクリックします。
5. 項目の横にある Remove アイコン をクリックします。この項目はブート順序の一覧から削除され、利用可能なブートソースの一覧に保存されます。ブート順序一覧からすべての項目を削除する場合、以下のメッセージが表示されます。No resource selected.仮想マシンは、YAML ファイルでの出現順にディスクからの起動を試行します。

手順

1. OpenShift Container Platform コンソールで、サイドメニューから Virtualization → VirtualMachines をクリックします。

2. 削除する仮想マシンの Options メニュー をクリックし、Delete を選択します。

   • または、仮想マシン名をクリックして VirtualMachine details ページを開き、Actions → Delete をクリックします。
3. 確認のポップアップウィンドウで、Delete をクリックし、仮想マシンを永続的に削除します。

手順

1. 次の例に従って VirtualMachineExport マニフェストを作成し、VirtualMachine、VirtualMachineSnapshot、または PersistentVolumeClaim CR からボリュームをエクスポートし、example-export.yaml として保存します。

   VirtualMachineExport の例

   apiVersion: export.kubevirt.io/v1alpha1
   kind: VirtualMachineExport
   metadata:
     name: example-export
   spec:
     source:
       apiGroup: "kubevirt.io" 1
       kind: VirtualMachine 2
       name: example-vm
     ttlDuration: 1h 3

   1

   適切な API グループを指定します。

   • VirtualMachine の "kubevirt.io"。
   • VirtualMachineSnapshot の "snapshot.kubevirt.io"。
   • PersistentVolumeClaim の ""。

   2

   VirtualMachine、VirtualMachineSnapshot、または PersistentVolumeClaim を指定します。

   3

   オプション:デフォルトの期間は 2 時間です。

2. VirtualMachineExport CR を作成します。

   $ oc create -f example-export.yaml

3. VirtualMachineExport CR を取得します。

   $ oc get vmexport example-export -o yaml

   エクスポートされたボリュームの内部および外部リンクは、status スタンザに表示されます。

   出力例

   apiVersion: export.kubevirt.io/v1alpha1
   kind: VirtualMachineExport
   metadata:
     name: example-export
     namespace: example
   spec:
     source:
       apiGroup: ""
       kind: PersistentVolumeClaim
       name: example-pvc
     tokenSecretRef: example-token
   status:
     conditions:
     - lastProbeTime: null
       lastTransitionTime: "2022-06-21T14:10:09Z"
       reason: podReady
       status: "True"
       type: Ready
     - lastProbeTime: null
       lastTransitionTime: "2022-06-21T14:09:02Z"
       reason: pvcBound
       status: "True"
       type: PVCReady
     links:
       external: 1
         cert: |-
           -----BEGIN CERTIFICATE-----
           ...
           -----END CERTIFICATE-----
         volumes:
         - formats:
           - format: raw
             url: https://vmexport-proxy.test.net/api/export.kubevirt.io/v1alpha1/namespaces/example/virtualmachineexports/example-export/volumes/example-disk/disk.img
           - format: gzip
             url: https://vmexport-proxy.test.net/api/export.kubevirt.io/v1alpha1/namespaces/example/virtualmachineexports/example-export/volumes/example-disk/disk.img.gz
           name: example-disk
       internal:  2
         cert: |-
           -----BEGIN CERTIFICATE-----
           ...
           -----END CERTIFICATE-----
         volumes:
         - formats:
           - format: raw
             url: https://virt-export-example-export.example.svc/volumes/example-disk/disk.img
           - format: gzip
             url: https://virt-export-example-export.example.svc/volumes/example-disk/disk.img.gz
           name: example-disk
     phase: Ready
     serviceName: virt-export-example-export

   1

   外部リンクは、Ingress または Route を使用してクラスターの外部からアクセスできます。

   2

   内部リンクは、クラスター内でのみ有効です。

手順

1. OpenShift Container Platform コンソールで、サイドメニューから Virtualization → VirtualMachines をクリックします。
2. スタンドアロン VMI を選択して、VirtualMachineInstance details ページを開きます。
3. Details タブで、Annotations または Labels の横にある鉛筆アイコンをクリックします。
4. 関連する変更を加え、Save をクリックします。

手順

1. Open Shift Container Platform Web コンソールで、サイドメニューからVirtualization → VirtualMachinesをクリックします。
2. Actions → Delete VirtualMachineInstance をクリックします。
3. 確認のポップアップウィンドウで、Delete をクリックし、スタンドアロン VMI を永続的に削除します。

手順

1. サイドメニューから Virtualization → VirtualMachines をクリックします。
2. 起動する仮想マシンが含まれる行を見つけます。

3. ユースケースに適したメニューに移動します。

   • 複数の仮想マシンでのアクションの実行が可能なこのページに留まるには、以下を実行します。

     1. 行の右端にある Options メニュー をクリックします。

   • 選択した仮想マシンを起動する前に、その仮想マシンの総合的な情報を表示するには、以下を実行します。

     1. 仮想マシンの名前をクリックして、VirtualMachine details ページにアクセスします。
     2. Actions をクリックします。
4. 再起動を選択します。
5. 確認ウィンドウで Start をクリックし、仮想マシンを起動します。

手順

1. サイドメニューから Virtualization → VirtualMachines をクリックします。
2. 再起動する仮想マシンが含まれる行を見つけます。

3. ユースケースに適したメニューに移動します。

   • 複数の仮想マシンでのアクションの実行が可能なこのページに留まるには、以下を実行します。

     1. 行の右端にある Options メニュー をクリックします。

   • 選択した仮想マシンを再起動する前に、その仮想マシンの総合的な情報を表示するには、以下を実行します。

     1. 仮想マシンの名前をクリックして、VirtualMachine details ページにアクセスします。
     2. Actions → Restart をクリックします。
4. 確認ウィンドウで Restart をクリックし、仮想マシンを再起動します。