第9章 virtctl および libguestfs CLI ツールの使用

virtctl コマンドラインツールを使用して、OpenShift Virtualization リソースを管理できます。

virtctl を使用して libguestfs-tools コンテナーをデプロイすることもできます。Libguestfs は、仮想マシン (VM) ディスクイメージにアクセスして変更するためのツールセットです。

9.1. virtctl のインストール

Linux、Windows、および MacOS オペレーティングシステムに virtctl をインストールするには、virtctl バイナリーファイルをダウンロードしてインストールします。

Red Hat Enterprise Linux (RHEL) に virtctl をインストールするには、OpenShift Virtualization リポジトリーを有効にしてから、kubevirt-virtctl パッケージをインストールします。

9.1.1. Linux、Windows、macOS への virtctl のインストール

オペレーティングシステム用の virtctl バイナリーをダウンロードしてインストールします。

手順

  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

9.1.2. RHEL への virtctl のインストール

OpenShift Virtualization リポジトリーを有効にし、kubevirt-virtctl パッケージをインストールすることにより、Red Hat Enterprise Linux (RHEL) に virtctl RPM をインストールします。

前提条件

  • クラスター内の各ホストは Red Hat Subscription Manager (RHSM) に登録されており、アクティブな OpenShift Container Platform サブスクリプションを持つ必要があります。

手順

  • subscription-manager CLI ツールを使用して、オペレーティングシステムに適切な OpenShift Virtualization リポジトリーを有効にします。

    • RHEL 9:

      # subscription-manager repos --enable cnv-4.13-for-rhel-9-x86_64-rpms
    • RHEL 8:

      # subscription-manager repos --enable cnv-4.13-for-rhel-8-x86_64-rpms
  • kubevirt-virtctl パッケージをインストールします。

    # yum install kubevirt-virtctl