第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 バイナリーをダウンロードしてインストールします。
手順
- OpenShift Container Platform Web コンソールで、Virtualization → Overview ページに移動します。
-
Download virtctl リンクをクリックして、オペレーティングシステム用の
virtctlバイナリーをダウンロードします。 virtctlをインストールします。Linux の場合
アーカイブファイルを解凍します。
$ tar -xvf <virtctl-version-distribution.arch>.tar.gz
次のコマンドを実行して、
virtctlバイナリーを実行可能にします。$ chmod +x <path/virtctl-file-name>
virtctlバイナリーをPATH 環境変数にあるディレクトリーに移動します。次のコマンドを実行して、パスを確認できます。
$ echo $PATH
KUBECONFIG環境変数を設定します。$ export KUBECONFIG=/home/<user>/clusters/current/auth/kubeconfig
Windows の場合:
- アーカイブファイルを解凍します。
-
展開したフォルダー階層に移動し、
virtctl実行可能ファイルをダブルクリックしてクライアントをインストールします。 virtctlバイナリーをPATH 環境変数にあるディレクトリーに移動します。次のコマンドを実行して、パスを確認できます。
C:\> path
MacOS の場合:
- アーカイブファイルを解凍します。
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-managerCLI ツールを使用して、オペレーティングシステムに適切な 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