4.20. template

template 资源类型是所有模板资源在 Red Hat Virtualization 环境中的组合。只需要 --vm-id|name 和 --name 参数。如果未指定自选参数，则模板将继承用来生成该模板的虚拟机所使用的设置。

表 4.50. 模板参数

名称类型描述必需的用户可创建用户可更新
--vm-id|name
字符串
作为基本模板使用的虚拟机的 ID 或名称。
是
是
否
--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 参数是使用下表中子参数的集合。

表 4.51. --sso-methods-method parameters

名称类型描述
method.id
字符串
要使用的单点登录方法。例如：GUEST_AGENT。
--custom_properties-custom_property 参数是一个使用下表中的子参数的集合。

表 4.52. --custom_properties-custom_property 参数

名称类型描述
custom_property.name
字符串
自定义属性名。
custom_property.value
字符串
自定义属性的值。
--os-boot 参数是使用下表中子参数的集合。

表 4.53. --os-boot parameters

名称类型描述
boot.dev
字符串
虚拟机模板的引导设备。请指定 cdrom、hd 或者 network。
--vm-disks-disk 参数是一个使用下表中的子参数的集合。

表 4.54. --vm-disks-disk 参数

名称类型描述
disk.id
字符串
虚拟机磁盘的标识。
storage_domains.storage_domain
集合
为磁盘存储域定义一组子参数。
--cpu-cpu_tune-vcpu_pin 参数是使用下表中的子参数的集合。

表 4.55. --cpu-cpu_tune-vcpu_pin parameters

名称类型描述
vcpu_pin.vcpu
整数
分配的虚拟 CPU。
vcpu_pin.cpu_set
字符串
主机中的物理 CPU。

例 4.41. 创建一个新模板

[RHEVM shell (connected)]# add template --name MyTemplate1 --vm-name MyVM1

例 4.42. 更新一个新模板

[RHEVM shell (connected)]# update template MyTemplate1 --memory 1073741824

例 4.43. 删除一个模板

[RHEVM shell (connected)]# remove template MyTemplate1
下表列出了针对一个虚拟机模板资源的操作。

表 4.56. 虚拟机模板操作

操作描述
export把模板导出到一个导出存储域中。