4.20. 模板
模板 资源类型对 Red Hat Virtualization 环境中的所有虚拟机模板进行分组。只有 --vm-id|name 和 --name 是必需的参数。如果没有指定可选参数，则模板将从用于制作模板的虚拟机中继承设置。
| 名称 | 类型 | Description | 必填 | 用户 Creatable | User Updatable |
|---|---|---|---|---|---|
--vm-id|name
|
字符串
|
对用作模板基础的虚拟机的引用。
|
是
|
是
|
否
|
--name
|
字符串
|
虚拟机模板的名称。
|
是
|
是
|
是
|
--memory
|
long
|
虚拟机模板的内存量，以字节为单位。
|
否
|
是
|
是
|
--cpu-topology-cores
|
int
|
虚拟机模板可用的 CPU 内核数。
|
否
|
是
|
是
|
--high_availability-enabled
|
布尔值
|
设置为
true，以便为虚拟机模板启用高可用性。
|
否
|
是
|
是
|
--os-cmdline
|
字符串
|
与定义的内核一起使用的内核命令行参数字符串。这个选项支持直接引导 Linux 内核，而不是通过 BIOS 引导装载程序引导。
|
否
|
是
|
是
|
--origin
|
字符串
|
虚拟机模板的源。指定
rhev 、 VMware 或 xen。
|
否
|
是
|
是
|
--high_availability-priority
|
int
|
设置每个虚拟机模板高可用性的优先级值（如引导顺序）。
|
否
|
是
|
是
|
--timezone
|
字符串
|
Windows 虚拟机模板的 Sysprep 时区设置。指定格式，如
GMT+00:00。
|
否
|
是
|
是
|
--domain-name
|
字符串
|
虚拟机模板的域名。
|
否
|
是
|
是
|
--type
|
字符串
|
定义虚拟机类型。指定
desktop 或 server。
|
否
|
是
|
是
|
--stateless
|
布尔值
|
如果生成的虚拟机是无状态的，则设置为
true。无状态虚拟机包含引导时获取的磁盘镜像的快照，并在关机时删除。这意味着状态更改在重启后不会保留。
|
否
|
是
|
是
|
--delete_protected
|
布尔值
|
设置为
true 以便无法删除从此模板创建的虚拟机。
|
否
|
是
|
是
|
--sso-methods-method
|
集合
|
定义所用的单点登录方法。例如，
--sso-methods-method method.id=GUEST_AGENT。
|
否
|
是
|
是
|
--rng_device-rate-bytes
|
int
|
指定每个期间内允许消耗的字节数。
|
否
|
是
|
是
|
--rng_device-rate-period
|
int
|
以毫秒为单位指定期间的持续时间。如果指定，则必须指定
--rng_device-rate-bytes。
|
否
|
是
|
是
|
--rng_device-source
|
字符串
|
随机数字生成器的来源。指定
random 或 hwrng。
|
否
|
是
|
是
|
--console-enabled
|
布尔值
|
设置为
true 以启用 VirtIO 控制台设备功能。
|
否
|
是
|
是
|
--placement_policy-affinity
|
字符串
|
从模板创建的每个虚拟机的迁移关联性。指定可
migratable、user_migratable 或 pinned。
|
否
|
是
|
是
|
--description
|
字符串
|
虚拟机模板的描述。
|
否
|
是
|
是
|
--comment
|
字符串
|
虚拟机模板的评论。
|
否
|
是
|
是
|
--custom_properties-custom_property
|
集合
|
一组用户定义的环境变量，作为参数传递给自定义脚本。
|
否
|
是
|
是
|
--os-type
|
字符串
|
虚拟机模板的操作系统类型。
|
否
|
是
|
是
|
--os-boot
|
集合
|
虚拟机模板的引导设备。指定
cdrom、hd 或 网络。例如： --os-boot boot.dev=hd。
|
否
|
是
|
是
|
--cpu-topology-sockets
|
int
|
虚拟机模板可用的 CPU 插槽数量。
|
否
|
是
|
是
|
--cpu_shares
|
int
|
虚拟机相对于其他虚拟机可能需要的 CPU 资源级别。例如
，512 代表低优先级虚拟机，1024 代表中等优先级虚拟机，2048 个高优先级虚拟机。
|
否
|
是
|
是
|
--cpu-architecture
|
字符串
|
定义 CPU 架构。指定
x86_64、ppc64 或 未定义。
|
否
|
是
|
是
|
--os-kernel
|
字符串
|
所生成的虚拟机配置为引导的内核镜像的路径。这个选项支持直接引导 Linux 内核，而不是通过 BIOS 引导装载程序引导。
|
否
|
是
|
是
|
--display-type
|
字符串
|
定义显示类型。指定
spice 或 vnc。
|
否
|
是
|
是
|
--display-monitors
|
int
|
定义可用显示的数量。
|
否
|
是
|
是
|
--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 引导装载程序引导。
|
否
|
是
|
是
|
--usb-enabled
|
布尔值
|
设置为
true 以在虚拟机上启用 USB 支持。此选项仅适用于使用 SPICE 协议的虚拟机。
|
否
|
是
|
是
|
--usb-type
|
字符串
|
如果启用 USB 支持，请定义 USB 类型。指定
Legacy 或 Native。
重要
Legacy USB 选项已弃用，并将在 Red Hat Virtualization 4.1 中删除。
|
否
|
是
|
是
|
--tunnel_migration
|
布尔值
|
设置为
true，以通过 libvirt 守护进程启用数据传输。隧道的传输使用更强大的加密算法，但会增加传输过程中的数据负载。
|
否
|
是
|
是
|
--migration_downtime
|
int
|
定义虚拟机在实时迁移期间可以停机的最大毫秒数。
|
否
|
是
|
是
|
--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。如果您要将此模板创建为根模板的子模板，则使用。
|
否
|
是
|
是
|
--cpu-cpu_tune-vcpu_pin
|
集合
|
定义要固定到主机的物理 CPU 的虚拟机 CPU。
|
否
|
是
|
是
|
--serial_number-policy
|
字符串
|
定义虚拟机模板的序列号策略。指定
主机、vm 或 自定义。如果使用 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
|
字符串
|
用于跨系统日志记录的操作标记标识符。如果客户端没有定义标识符，则会生成一个。
|
否
|
是
|
是
|
--sso-methods-method 参数是下表中使用子参数的集合。
| 名称 | 类型 | Description |
|---|---|---|
method.id
|
字符串
|
使用的单点登录方法：
GUEST_AGENT。
|
--custom_properties-custom_property 参数是下表中使用子参数的集合。
| 名称 | 类型 | Description |
|---|---|---|
custom_property.name
|
字符串
|
自定义属性名称。
|
custom_property.value
|
字符串
|
自定义属性值。
|
--os-boot 参数是一个集合，其使用下表中的子参数。
| 名称 | 类型 | Description |
|---|---|---|
boot.dev
|
字符串
|
虚拟机模板的引导设备。指定
cdrom、hd 或 网络。
|
--vm-disks-disk 参数是下表中使用子参数的集合。
| 名称 | 类型 | Description |
|---|---|---|
disk.id
|
字符串
|
对虚拟磁盘的引用。
|
storage_domains.storage_domain
|
集合
|
为磁盘的存储域定义一组子参数。
|
--cpu-cpu_tune-vcpu_pin 参数是下表中使用子参数的集合。
| 名称 | 类型 | Description |
|---|---|---|
vcpu_pin.vcpu
|
int
|
要分配的虚拟 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
下表列出了虚拟机模板资源的操作。
| 操作 | Description |
|---|---|
export | 将模板导出到导出存储域。 |
