Red Hat Training

A Red Hat training course is available for Red Hat Enterprise Linux

21.12. virt-customize: 仮想マシンのカスタマイズ

virt-customize コマンドラインツールを使用して、仮想マシンをカスタマイズできます。たとえば、パッケージをインストールして設定ファイルを編集するなどができます。
virt-customize を使用するには、ゲスト仮想マシンをオフラインにする必要があります。そのため、コマンドを実行する前にシャットダウンする必要があります。virt-customize は、ゲストのコピーを作成せずに、ゲストまたはディスクイメージを変更することに注意してください。ゲスト仮想マシンの既存のコンテンツを保持するには、最初にディスクをコピーまたはクローンする必要があります。ディスクのコピーおよびクローン作成の詳細は、「 libguestfs.org 」を参照してください。
警告
ライブ仮想マシンで virt-customize を使用するか、他のディスク編集ツールと同時にディスクが破損する可能性があります。このコマンドを使用する前に、仮想マシンをシャットダウンする必要があります。また、ディスクイメージを同時に編集することはできません。
root として virt-customize を実行しないことを推奨します。
virt-customize をインストールするには、以下のいずれかのコマンドを実行します。
# yum install /usr/bin/virt-customize
または
# yum install libguestfs-tools-c
virt-customize とともに使用するには、以下のコマンドオプションを使用することができます。

表21.2 virt-customize オプション

コマンド 説明
--help 特定のコマンドまたは virt-customize ユーティリティーに関する簡単なヘルプエントリーを表示します。その他のヘルプは、man ページの virt-customize を参照してください。 virt-customize --help
-a [file] or --add [file] 指定したファイルを追加します。このファイルは、ゲスト仮想マシンのディスクイメージです。ディスクイメージの形式は自動検出されます。これを上書きして、特定の形式を強制するには、--format オプションを使用します。 virt-customize --add /dev/vms/disk.img
-A [URI] or --add [URI] リモートディスクを追加します。URI 形式は guestfish と互換性があります。「guestfish を使用したファイルの追加」 virt-customize -a rbd://example.com[:port]/pool/disk
-c [URI] or --connect [URI] libvirt を使用している場合は、指定の URI に接続します。省略されている場合は、KVM ハイパーバイザーを介して接続します。ゲストブロックデバイスを直接指定する場合(virt-customize -a)、libvirt は全く使用されません。 virt-customize -c qemu:///system
-d [guest] or --domain [guest] 指定したゲスト仮想マシンからすべてのディスクを追加します。ドメインの UUID は、ドメイン名の代わりに使用できます。 virt-customize --domain 90df2f3f-8857-5ba9-2714-7d95907b1c9e
-n or --dry-run ゲスト仮想マシンで読み取り専用の「ドライラン」カスタマイズ操作を実行します。これにより、カスタマイズ操作が実行されますが、最後にディスクへの変更がなくなります。 virt-customize -n
--format [raw|qcow2|auto] -a オプションのデフォルトは、ディスクイメージの形式を自動検出することです。これを使用すると、コマンドラインでの -a オプションに対するディスク形式が強制的に実行されます。--format auto スイッチを使用すると、後続のオプション(上記の -a コマンドを参照)の自動検出に戻ります。 virt-customize --format raw -a disk.img は、disk.img の raw 形式(自動検出なし) を強制的に実行しますが、virt-customize --format raw -a disk.img --format auto -aanother .img に対する raw 形式(自動検出なし) を強制的に実行し、別の.img の自動検出に戻ります。信頼できない未フォーマットのゲストディスクイメージがある場合は、このオプションを使用してディスク形式を指定する必要があります。これにより、悪意のあるゲストでセキュリティー上の問題を回避することができます。
-m [MB] or --memsize [MB] --run スクリプトに割り当てられるメモリーの量を変更します。--run スクリプトまたは --install オプションにより、メモリー不足の問題が生じた場合は、メモリー割り当てを増やします。 virt-customize --memsize 1024
--network or --no-network インストール時にゲストからネットワークアクセスを有効または無効にします。デフォルトは enabled です。--no-network を使用してアクセスを無効にします。このコマンドは、ブート後にネットワークへのゲストアクセスには影響を与えません。詳細は、Libguestfs ドキュメント を参照してください virt-customize -a http://[user@]example.com[:port]/disk.img
-q または --quiet ログメッセージの出力を防ぎます。 virt-customize -q
-SMP [N] --install スクリプトで使用できる仮想 CPU N を有効にします。N は 2 以上でなければなりません。 virt-customize -smp 4
-v or --verbose デバッグの目的で詳細なメッセージを有効にします。 virt-customize --verbose
-v または --version virt-customize バージョン番号を表示して終了します。 virt-customize --V
-x libguestfs API 呼び出しのトレースを有効にします。 virt-customize -x
virt-customize コマンドでは、カスタマイズオプションを使用してゲストのカスタマイズ方法を設定します。以下は、--selinux-relabel カスタマイズオプションに関する情報を提供します。
ゲスト内の --selinux-relabel カスタマイズオプションにより、適切な SELinux ラベルが持てるように、ゲスト内の --selinux-relabel カスタマイズオプションが変更されます。このオプションは、ファイルの再ラベルをすぐに試みます。失敗した場合は、イメージで /.autorelabel がアクティブ化されます。これにより、イメージの次回起動時に再ラベル付けの操作がスケジュールされます。
注記
このオプションは、SELinux に対応するゲストにのみ使用してください。
以下の例では、GIMP および Inkscape パッケージをゲストにインストールし、次回ゲスト起動時に SELinux ラベルが正しいことを確認します。

例21.1 virt-customize を使用したゲストへのパッケージのインストール

virt-customize -a disk.img --install gimp,inkscape --selinux-relabel
カスタマイズオプションなどの詳細は、libguestfs.org を参照してください。

このページには機械翻訳が使用されている場合があります (詳細はこちら)。