virt-install 使用說明

小吉猫發表於2025-01-24
virt-install -h
usage: virt-install --name NAME --memory MB STORAGE INSTALL [options]

使用指定安裝介質新建虛擬機器

optional arguments:
  -h, --help            輸出幫助資訊並退出
  --version             輸出版本號並退出
  --connect URI         透過 libvirt URI 連線到 hypervisor 

General Options:
  -n NAME, --name NAME  客戶端虛擬機器名稱
  --memory MEMORY       指定虛擬機器的記憶體大小(以MB為單位) Ex:
                        --memory 1024 (in MiB)
                        --memory 512,maxmemory=1024
                        --memory 512,maxmemory=1024,hotplugmemorymax=2048,hotplugmemoryslots=2
  --vcpus VCPUS         配置虛擬機器 vcpus 個數 Ex:
                        --vcpus 5
                        --vcpus 5,maxvcpus=10,cpuset=1-4,6,8
                        --vcpus sockets=2,cores=4,threads=2
  --cpu CPU             cpu 型號及功能 Ex:
                        --cpu coreduo,+x2apic
                        --cpu host-passthrough
                        --cpu host
  --metadata METADATA   配置虛擬機器後設資料 Ex:
                        --metadata name=foo,title="My pretty title",uuid=...
                        --metadata description="My nice long description"

Installation Method Options:
  --cdrom CDROM                           光碟機安裝介質
  -l LOCATION, --location LOCATION        發行版安裝的 url eg. https://host/path. 
  --pxe                                   使用 pxe 協議透過網路引導
  --import                                在儲存磁碟映象中構建虛擬機器
  --livecd                                將光碟機介質視為 Live CD
  -x EXTRA_ARGS, --extra-args EXTRA_ARGS  傳遞給從 --location 啟動的安裝核心的附加引數。
  --initrd-inject INITRD_INJECT           將給定檔案新增到 --location 的initrd根目錄。
  --boot BOOT           配置客戶機啟動設定. Ex:
                        --boot hd,cdrom,menu=on
                        --boot init=/sbin/init (for containers)
  --idmap IDMAP         為LXC容器啟用使用者名稱空間. Ex:
                        --idmap uid_start=0,uid_target=1000,uid_count=10

OS options:
  --os-variant DISTRO_VARIANT  指定要安裝的作業系統變種,以最佳化相關設定(如 virtio)。例如,--os-variant ubuntu20.04。
                        
Device Options:
  --disk DISK           指定儲存裝置,可以選擇新建儲存或使用現有儲存。 Ex.
                        --disk size=10 (新建10GiB的映象)
                        --disk /my/existing/disk,cache=none
                        --disk device=cdrom,bus=scsi
                        --disk=?
  -w NETWORK, --network NETWORK 
                        配置虛擬機器的網路介面 Ex:
                        --network bridge=mybr0
                        --network network=my_libvirt_virtual_net
                        --network network=mynet,model=virtio,mac=00:11...
                        --network none
                        --network help
  --graphics GRAPHICS   配置虛擬機器的顯示設定。 Ex:
                        --graphics vnc
                        --graphics spice,port=5901,tlsport=5902
                        --graphics none
                        --graphics vnc,password=foobar,port=5910,keymap=ja
  --controller CONTROLLER
                        配置虛擬裝置控制器。 Ex:
                        --controller type=usb,model=qemu-xhci
                        --controller virtio-scsi
  --input INPUT         配置虛擬機器的輸入裝置。 Ex:
                        --input tablet
                        --input keyboard,bus=usb
  --serial SERIAL       配置串列埠
  --parallel PARALLEL   配置並口裝置。
  --channel CHANNEL     配置虛擬機器與主機之間的通訊通道。
  --console CONSOLE     配置虛擬機器與主機之間的文字控制檯連線
  --hostdev HOSTDEV     配置物理USB/PCI裝置共享給虛擬機器。
  --filesystem FILESYSTEM
                        將主機目錄傳遞給虛擬機器。 Ex: 
                        --filesystem /my/source/dir,/dir/in/guest
                        --filesystem template_name,/,type=template
  --sound [SOUND]       配置虛擬機器的聲音裝置模擬。
  --watchdog WATCHDOG   配置虛擬機器的看門狗裝置。
  --video VIDEO         配置虛擬機器的影片硬體。
  --smartcard SMARTCARD
                        配置虛擬機器的智慧卡裝置。 Ex:
                        --smartcard mode=passthrough
  --redirdev REDIRDEV   配置裝置重定向。 Ex:
                        --redirdev usb,type=tcp,server=192.168.1.1:4000
  --memballoon MEMBALLOON
                        配置虛擬機器 memballoon 裝置. Ex:
                        --memballoon model=virtio
  --tpm TPM             配置虛擬機器的TPM裝置。. Ex:
                        --tpm /dev/tpm
  --rng RNG             配置虛擬機器的隨機數生成器。 Ex:
                        --rng /dev/urandom
  --panic PANIC         配置虛擬機器的崩潰處理。 Ex:
                        --panic default
  --memdev MEMDEV       配置虛擬機器的記憶體裝置。 Ex:
                        --memdev dimm,target_size=1024
  --vsock VSOCK         配置虛擬機器的虛擬套接字。 Ex:
                        --vsock auto_cid=yes
                        --vsock cid=7

Guest Configuration Options:
  --security SECURITY   設定域的安全驅動程式配置。
  --cputune CPUTUNE     調整域程序的 CPU 引數。
  --numatune NUMATUNE   調整域程序的 NUMA 策略。
  --memtune MEMTUNE     調整域程序的記憶體策略。
  --blkiotune BLKIOTUNE
                        調整域程序的塊 I/O 策略。
  --memorybacking MEMORYBACKING
                        設定域程序的記憶體背書策略。示例:--memorybacking hugepages=on。
  --features FEATURES   Set domain <features> XML. Ex:
                        --features acpi=off
                        --features apic=on,eoi=on
  --clock CLOCK         Set domain <clock> XML. Ex:
                        --clock offset=localtime,rtc_tickpolicy=catchup
  --pm PM               配置 VM 電源管理功能。
  --events EVENTS       配置 VM 生命週期管理策略。
  --resource RESOURCE   配置 VM 資源分配(cgroups)。
  --sysinfo SYSINFO     配置 SMBIOS 系統資訊。 Ex:
                        --sysinfo host
                        --sysinfo bios_vendor=MyVendor,bios_version=1.2.3,...
  --qemu-commandline QEMU_COMMANDLINE
                        直接將引數傳遞給 qemu 模擬器。 Ex:
                        --qemu-commandline='-display gtk,gl=on'
                        --qemu-commandline env=DISPLAY=:0.1

Virtualization Platform Options:
  -v, --hvm             該客戶機應為完全虛擬化的客戶機。
  -p, --paravirt        該客戶機應為半虛擬化的客戶機。
  --container           該客戶機應為容器客戶機。
  --virt-type VIRT_TYPE
                        要使用的虛擬化程式名稱(如 kvm、qemu、xen 等)。
  --arch ARCH           要模擬的 CPU 架構。
  --machine MACHINE     要模擬的機器型別。

Miscellaneous Options:
  --autostart           開機自啟動虛擬機器
  --transient           建立一個短暫的域。短暫的域在安裝完成後不會被儲存。
  --destroy-on-exit     當控制檯檢視器關閉時,強制關閉域。
  --wait WAIT           等待安裝完成的時間(分鐘)。
  --noautoconsole       不要自動嘗試連線到客戶機控制檯。
  --noreboot            完成安裝後不要重啟客戶機。
  --print-xml [XMLONLY]
                        列印生成的域XML,而不是建立客戶機。這可以用於檢視或除錯生成的XML配置。
  --dry-run             透過安裝過程執行,但不建立裝置或定義客戶機。這可以用於檢查配置是否正確。
  --check CHECK         啟用或停用驗證檢查。例如,--check path_in_use=off 或 --check all=off 可以關閉特定的檢查或全部檢查。 Example:
                        --check path_in_use=off
                        --check all=off
  -q, --quiet           禁止無錯誤輸出
  -d, --debug           Print debugging information

Use '--option=?' or '--option help' to see available suboptions
See man page for examples and full option syntax.

相關文章