5.5. virtctl クライアントの有効化
virtctl
クライアントは、OpenShift Virtualization リソースを管理するためのコマンドラインユーティリティーです。これは、Linux、macOS、および Windows ディストリビューションで利用できます。
5.5.1. virtctl クライアントのダウンロードおよびインストール
5.5.1.1. virtctl クライアントのダウンロード
ConsoleCLIDownload
カスタムリソース (CR) で提供されるリンクを使用して virtctl
クライアントをダウンロードします。
手順
以下のコマンドを実行して
ConsoleCLIDownload
オブジェクトを表示します。$ oc get ConsoleCLIDownload virtctl-clidownloads-kubevirt-hyperconverged -o yaml
-
お使いのディストリビューションにリスト表示されているリンクを使用して
virtctl
クライアントをダウンロードします。
5.5.1.2. virtctl クライアントのインストール
オペレーティングシステムに適した場所からダウンロードした後に、virtctl
クライアントをデプロイメントし、インストールします。
前提条件
-
virtctl
クライアントをダウンロードしている。
手順
Linux の場合
tarball を展開します。以下の CLI コマンドは、tarball と同じディレクトリーにデプロイメントします。
$ tar -xvf <virtctl-version-distribution.arch>.tar.gz
デプロイメントしたフォルダー階層に移動し、以下のコマンドを実行して
virtctl
バイナリーを実行可能にします。$ chmod +x <virtctl-file-name>
-
virtctl
バイナリーをPATH 環境変数
にあるディレクトリーに移動します。 パスを確認するには、以下のコマンドを実行します。
$ echo $PATH
Windows ユーザーの場合:
- アーカイブを展開し、解凍します。
-
展開したフォルダー階層に移動し、
virtctl
実行可能ファイルをダブルクリックしてクライアントをインストールします。 -
virtctl
バイナリーをPATH 環境変数
にあるディレクトリーに移動します。 パスを確認するには、以下のコマンドを実行します。
C:\> path
macOS ユーザーの場合:
- アーカイブを展開し、解凍します。
-
virtctl
バイナリーをPATH 環境変数
にあるディレクトリーに移動します。 パスを確認するには、以下のコマンドを実行します。
echo $PATH
5.5.2. virtctl RPM パッケージのインストール
OpenShift Virtualization リポジトリーを有効にした後、virtctl
クライアントを RPM としてインストールできます。
5.5.2.1. OpenShift Virtualization リポジトリーの有効化
Red Hat Enterprise Linux (RHEL) のバージョンの OpenShift Virtualization リポジトリーを有効にします。
前提条件
- システムは、Red Hat Container Native Virtualization エンタイトルメントへの有効なサブスクリプションを持つ Red Hat アカウントに登録されています。
手順
subscription-manager
CLI ツールを使用して、オペレーティングシステムに適切な OpenShift Virtualization リポジトリーを有効にします。RHEL 8 のリポジトリーを有効にするには、次を実行します。
# subscription-manager repos --enable cnv-4.11-for-rhel-8-x86_64-rpms
RHEL 7 のリポジトリーを有効にするには、次を実行します。
# subscription-manager repos --enable rhel-7-server-cnv-4.11-rpms
5.5.2.2. yum ユーティリティーを使用した virtctl クライアントのインストール
kubevirt-virtctl
パッケージから virtctl
クライアントをインストールします。
前提条件
- Red Hat Enterprise Linux (RHEL) システムで OpenShift Virtualization リポジトリーを有効にしました。
手順
kubevirt-virtctl
パッケージをインストールします。# yum install kubevirt-virtctl
5.5.3. 関連情報
- OpenShift Virtualization の CLI ツールの使用。