红帽全球峰会4.20. template
template 资源类型是所有模板资源在 Red Hat Enterprise Virtualization 环境中的组合。只需要 --vm-id|name 和 --name 参数。如果未指定自选参数，则模板将继承用来生成该模板的虚拟机所使用的设置。
| 名称 | 类型 | 描述 | 必需的 | 用户可创建 | 用户可更新 |
|---|---|---|---|---|---|
--vm-id|name
|
字符串
|
作为基本模板使用的虚拟机参考。
|
是
|
是
|
否
|
--name
|
字符串
|
虚拟机模板名称。
|
是
|
是
|
是
|
--memory
|
长整数
|
虚拟机模板的内存大小（以字节为单位）
|
否
|
是
|
是
|
--cpu-topology-cores
|
整数
|
虚拟机模板可用的 CPU 内核数量。
|
否
|
是
|
是
|
--high_availability-enabled
|
布尔值
|
设为
true 以便为虚拟机启用高可用性。
|
否
|
是
|
是
|
--os-cmdline
|
字符串
|
内核需要使用的内核命令行参数。这个选项支持直接引导一个 Linux 内核，而不需要使用 BIOS bootloader。
|
否
|
是
|
是
|
--origin
|
字符串
|
虚拟机模板的原形。请指定
rhev、vmware 或者 xen。
|
否
|
是
|
是
|
--high_availability-priority
|
整数
|
设置虚拟机模板高可用性的优先级（如引导顺序）。
|
否
|
是
|
是
|
--timezone
|
字符串
|
Windows 虚拟机模板在 Sysprep 中的时区设置。请指定类似
GMT+00:00 的格式。
|
否
|
是
|
是
|
--domain-name
|
字符串
|
虚拟机模板的域名。
|
否
|
是
|
是
|
--type
|
字符串
|
定义虚拟机的类型，请指定
desktop 或者 server。
|
否
|
是
|
是
|
--stateless
|
布尔值
|
如果虚拟机处于无状态（stateless），则将这个参数设为
true。无状态的虚拟机会在系统启动时提取磁盘快照，并在关机时删除对系统所做的所有改变。这意味着每次重启后将丢失对系统所做改动。
|
否
|
是
|
是
|
--delete_protected
|
布尔值
|
设为
true 以便无法删除使用此模板创建的虚拟机。
|
否
|
是
|
是
|
--sso-methods-method
|
集合
|
定义要使用的单点登录方法。例如：
--sso-methods-method method.id=GUEST_AGENT。
|
否
|
是
|
是
|
--rng_device-rate-bytes
|
整数
|
指定每个周期中允许消耗的字节数。
|
否
|
是
|
是
|
--rng_device-rate-period
|
整数
|
以毫秒为单位指定周期时间。如果指定该参数，就也必须要指定 。
--rng_device-rate-bytes。
|
否
|
是
|
是
|
--rng_device-source
|
字符串
|
随机数产生器的资源。请指定
random 或者 hwrng。
|
否
|
是
|
是
|
--console-enabled
|
布尔值
|
设为
true 以便启用 VirtIO 控制台设备功能。
|
否
|
是
|
是
|
--placement_policy-affinity
|
字符串
|
使用该模板创建的虚拟机的迁移关联（migration affinity），请指定
migratable、user_migratable 或者 pinned。
|
否
|
是
|
是
|
--description
|
字符串
|
虚拟机模板描述。
|
否
|
是
|
是
|
--comment
|
字符串
|
虚拟机模板注释。
|
否
|
是
|
是
|
--custom_properties-custom_property
|
集合
|
传递给脚本的一组用户自定义的环境变量。
|
否
|
是
|
是
|
--os-type
|
字符串
|
虚拟机模板的操作系统类型。
|
否
|
是
|
是
|
--os-boot
|
集合
|
虚拟机模板的引导设备。请指定
cdrom、hd 或者 network。例如：--os-boot boot.dev=hd。
|
否
|
是
|
是
|
--cpu-topology-sockets
|
整数
|
虚拟机模板可用的 CPU 插槽数量。
|
否
|
是
|
是
|
--cpu_shares
|
整数
|
相比其他虚拟机可要求的 CPU 资源水平。例如：低优先级虚拟机使用
512，中等优先级虚拟机使用 1024，而高优先级虚拟机使用 2048。
|
否
|
是
|
是
|
--cpu-architecture
|
字符串
|
定义 CPU 架构。请指定
x86_64、ppc64 或者 undefined。
|
否
|
是
|
是
|
--os-kernel
|
字符串
|
到基于模板所创建的虚拟机的引导内核映像的路径。这个选项支持直接引导 Linux 内核，而不需要 BIOS bootloader。
|
否
|
是
|
是
|
--display-type
|
字符串
|
定义显示类型，请指定
spice 或 vnc。
|
否
|
是
|
是
|
--display-monitors
|
整数
|
定义可用的显示数量。
|
否
|
是
|
是
|
--display-single_qxl_pci
|
布尔值
|
设为
true 以便使用单一虚拟 PCI 设备驱动多台显示器。
|
否
|
是
|
是
|
--display-allow_override
|
布尔值
|
设为
true 以便可以覆盖模板控制台设置。
|
否
|
是
|
是
|
--display-smartcard_enabled
|
布尔值
|
设为
true 以便为虚拟机启用智能卡功能。
|
否
|
是
|
是
|
--display-file_transfer_enabled
|
布尔值
|
设为
true 以便启用 SPICE 文件传输。
|
否
|
是
|
是
|
--display-copy_paste_enabled
|
布尔值
|
设为
true 以便启用 SPICE 剪切版复制和粘贴。
|
否
|
是
|
是
|
--display-keyboard_layout
|
字符串
|
定义虚拟机键盘类型。只有使用 VNC 协议时这个选项才有效。请指定类似
en-US 的格式。
|
否
|
是
|
是
|
--os-initRd
|
字符串
|
指定到一个指定内核所使用的 initrd 映像的路径。这个选项支持直接引导 Linux 内核，而不需要 BIOS bootloader。
|
否
|
是
|
是
|
--usb-enabled
|
布尔值
|
设定为
true 以便在该虚拟机中启用 USB 支持。这个选项只可用于使用 SPICE 协议的虚拟机。
|
否
|
是
|
是
|
--usb-type
|
字符串
|
如果已启用 USB 支持，则定义 USB 类型。请指定
Legacy 或者 Native。
|
否
|
是
|
是
|
--tunnel_migration
|
布尔值
|
设为
true 启用使用 libvirt 守护进程进行数据传输的功能。隧道传输使用更强大的加密算法，但会增加传输过程中的数据负载。
|
否
|
是
|
是
|
--migration_downtime
|
整数
|
以毫秒为单位定义进行实时迁移时虚拟机可以停机的最长时间。
|
否
|
是
|
是
|
--virtio_scsi-enabled
|
布尔值
|
设为
true 以便在该虚拟机中添加 VirtIO 控制台设备。
|
否
|
是
|
是
|
--soundcard_enabled:
|
布尔值
|
设为
true 以便启用声卡。
|
否
|
是
|
是
|
--vm-disks-disk
|
集合
|
附加到模板中的磁盘。
|
否
|
是
|
否
|
--id
|
字符串
|
虚拟机模板 ID。
|
否
|
是
|
是
|
--permissions-clone
|
布尔值
|
设为
true 以便将源虚拟机权限复制到模板中。
|
否
|
是
|
是
|
--version-version_name
|
字符串
|
与
--version-base_template-id 参数一同使用。定义子模板名称。
|
否
|
是
|
是
|
--version-base_template-id
|
字符串
|
定义作为 root 模板使用的模板 ID。如果要创建这个模板作为 root 模板的子模板使用，则请使用此参数。
|
否
|
是
|
是
|
--cpu-cpu_tune-vcpu_pin
|
集合
|
定义虚拟机中哪个虚拟 CPU 要与主机物理 CPU 固定（pin）。
|
否
|
是
|
是
|
--serial_number-policy
|
字符串
|
定义虚拟机模板的序列号策略。请指定
host、vm 或者 custom。如果使用 custom，则还要使用 --serial_number-value 定义序列号。
|
否
|
是
|
是
|
--serial_number-value
|
字符串
|
定义虚拟机模板的序列号。
|
否
|
是
|
是
|
--bios-boot_menu-enabled
|
布尔值
|
设为
true 以便启用引导菜单。
|
否
|
是
|
是
|
--cluster-id
|
字符串
|
通过指定集群 ID 定义要使用的集群。
|
否
|
是
|
是
|
--cluster-name
|
字符串
|
通过指定集群名称定义要使用的集群。
|
否
|
是
|
是
|
--cpu_profile-id
|
字符串
|
定义要使用的 CPU 配置文件。请使用
list cpuprofiles 命令查询 CPU 配置文件 ID 完整列表。
|
否
|
是
|
是
|
--expect
|
'201-created'
|
返回预期 HTTP 标头前，请求以异步的方式进行处理。它对长线任务非常有用，可以防止在任务完成前返回成功信号。
|
否
|
是
|
是
|
--correlation_id
|
字符串
|
跨系统日志操作标识符。如果客户端没有定义，系统将会自动生成该标识符。
|
否
|
是
|
是
|
--vm-disks-disk 参数是使用下表中子参数的集合。
| 名称 | 类型 | 描述 |
|---|---|---|
method.id
|
字符串
|
要使用的单点登录方法。例如：
GUEST_AGENT。
|
--custom_properties-custom_property 参数是一个使用下表中的子参数的集合。
| 名称 | 类型 | 描述 |
|---|---|---|
custom_property.name
|
字符串
|
自定义属性名。
|
custom_property.value
|
字符串
|
自定义属性的值。
|
--os-boot 参数是使用下表中子参数的集合。
| 名称 | 类型 | 描述 |
|---|---|---|
boot.dev
|
字符串
|
虚拟机模板的引导设备。请指定
cdrom、hd 或者 network。
|
--vm-disks-disk 参数是一个使用下表中的子参数的集合。
| 名称 | 类型 | 描述 |
|---|---|---|
disk.id
|
字符串
|
虚拟机磁盘的标识。
|
storage_domains.storage_domain
|
集合
|
为磁盘存储域定义一组子参数。
|
--cpu-cpu_tune-vcpu_pin 参数是使用下表中的子参数的集合。
| 名称 | 类型 | 描述 |
|---|---|---|
vcpu_pin.vcpu
|
整数
|
分配的虚拟 CPU。
|
vcpu_pin.cpu_set
|
字符串
|
主机中的物理 CPU。
|
例 4.40. 创建一个新模板
[RHEVM shell (connected)]# add template --name MyTemplate1 --vm-name MyVM1
[RHEVM shell (connected)]# add template --name MyTemplate1 --vm-name MyVM1例 4.41. 更新一个新模板
[RHEVM shell (connected)]# update template MyTemplate1 --memory 1073741824
[RHEVM shell (connected)]# update template MyTemplate1 --memory 1073741824例 4.42. 删除一个模板
[RHEVM shell (connected)]# remove template MyTemplate1
[RHEVM shell (connected)]# remove template MyTemplate1
下表列出了针对一个虚拟机模板资源的操作。
| 操作 | 描述 |
|---|---|
export | 把模板导出到一个导出存储域中。 |
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}