附录 A. 镜像配置参数

architecture

hypervisor 支持的 CPU 架构。例如，x86_64、arm 或 ppc64。运行 uname -m 来获得一个机器的架构信息。我们强烈推荐使用 libosinfo project 中定义的架构数据名称。

所有

hypervisor_type

hypervisor 的类型。

kvm、vmware

所有

instance_uuid

对于快照镜像，这个值就是创建这个镜像的服务器的 UUID。

有效的服务器 UUID

所有

kernel_id

在引导一个 AMI 镜像时，作为内核使用的、存储于Image 服务中的镜像 ID。

有效的镜像 ID

所有

os_distro

操作系统的通用名称（使用小写）。请使用 libosinfo project 中定义的名称。在这个项中只指定可以被识别的名称，过时的名称同时被列在这里来帮助您找到可识别的名称。

所有

os_version

发行厂商指定的操作系统版本。

版本号（例如，"11.10"）

所有

ramdisk_id

在引导一个 AMI 镜像时，作为 ramdisk 使用的、存储于Image 服务中的镜像 ID。

有效的镜像 ID

所有

vm_mode

虚拟机模式。它代表了为虚拟机使用的主机/客户机 ABI（application binary interface）。

hvm - 完全虚拟化。QEMU 和 KVM 使用这个模式。

libvirt API 驱动

hw_disk_bus

指定附加到磁盘设备的磁盘控制器类型。

scsi、virtio、ide 或 usb。

libvirt API 驱动

hw_numa_nodes

对实例有效的 NUMA 节点的数量（不会覆盖 flavor 的定义）。

整数。关于 NUMA 拓扑定义的详情，请参阅添加元数据中关于 hw:NUMA_def 关键字的介绍。

libvirt API 驱动

hw_numa_mempolicy

NUMA 内存分配策略（不会覆盖 flavor 的定义）。

strict - 强制实例的内存分配来自于和它绑定的 NUMA 节点（如果设置了 numa_nodes，这是默认值）。preferred - 内核可以使用其它节点。当 'hw:numa_nodes' 被设置为 '1' 时会有用。

libvirt API 驱动

hw_numa_cpus.0

vCPU N-M 到 NUMA 节点 0 的映射（不会覆盖 flavor 的定义）。

用逗号隔开的整数列表

libvirt API 驱动

hw_numa_cpus.1

vCPU N-M 到 NUMA 节点 1 的映射（不会覆盖 flavor 的定义）。

用逗号隔开的整数列表

libvirt API 驱动

hw_numa_mem.0

把 N GB 内存映射到 NUMA 节点 0（不会覆盖 flavor 的定义）。

整数

libvirt API 驱动

hw_numa_mem.1

把 N GB 内存映射到 NUMA 节点 1（不会覆盖 flavor 的定义）。

整数

libvirt API 驱动

hw_qemu_guest_agent

guest agent 支持。如果设为 yes，qemu-ga 也被安装，文件系统就可以被静默（quiesced 或称为 frozen），并自动创建快照。

yes / no

libvirt API 驱动

hw_rng_model

为镜像实例添加的一个随机数生成器。云管理员可以通过配置实例的 flavor 来启用并控制设备的行为。在默认情况下：

* The generator device is disabled. * /dev/random is used as the default entropy source. To specify a physical HW RNG device, use the following option in the nova.conf file: rng_dev_path=/dev/hwrng

virtio，或其它支持的设备。

libvirt API 驱动

hw_scsi_model

启用 VirtIO SCSI（virtio-scsi）来为 compute 实例提供块设备访问。在默认情况下，实例使用 VirtIO Block（virtio-blk）。VirtIO SCSI 是一个半虚拟化的 SCSI 控制器设备，它可以提供更高的可扩展性和性能，并支持高级 SCSI 硬件。

virtio-scsi

libvirt API 驱动

hw_video_model

使用的视频驱动

vga、cirrus、vmvga、xen 或 qxl

libvirt API 驱动

hw_video_ram

视频影像的最大内存数量。它只有当 hw_video:ram_max_mb 在 flavor 的 extra_specs 中设置，而且它的值大于 hw_video_ram 中设置的值时才有效。

整数（以 MB 为单位，如 '64'）

libvirt API 驱动

hw_watchdog_action

启用一个虚拟硬件 watchdog 设备，它会在服务器停止工作时执行指定的任务。watchdog 使用 i6300esb 设备（仿真一个 PCI Intel 6300ESB）。如果 hw_watchdog_action 没有指定，watchdog 将被禁用。

libvirt API 驱动

os_command_line

libvirt 驱动使用的内核命令行（替代默认值）。对于 Linux Containers（LXC），这个值被用作初始化参数。这个关键字只对 Amazon 内核、ramdisk 和机器镜像（aki、ari 和 ami）有效。

libvirt API 驱动和 VMware API 驱动

hw_vif_model

指定要使用的虚拟网络接口设备的型号。

有效值取决于配置的 hypervisor。

* KVM and QEMU: e1000, ne2k_pci, pcnet, rtl8139, and virtio. * VMware: e1000, e1000e, VirtualE1000, VirtualE1000e, VirtualPCNet32, VirtualSriovEthernetCard, and VirtualVmxnet. * Xen: e1000, netfront, ne2k_pci, pcnet, and rtl8139.

VMware API 驱动

vmware_adaptertype

hypervisor 使用的虚拟 SCSI 或 IDE 控制器。

lsiLogic、busLogic 或 ide

VMware API 驱动

vmware_ostype

一个 VMware GuestID，它描述了安装在镜像中的操作系统。当创建虚拟机时，这个值被传递给 hypervisor。如果没有指定，这个关键字的值被默认设为 otherGuest。

请参阅 thinkvirt.com。

VMware API 驱动

vmware_image_version

当前没有使用。

1

XenAPI 驱动

auto_disk_config

如果设为 true，磁盘的 root 分区会在实例引导前自动重新调整它的大小。这个值只在 Compute 服务使用一个带有 XenAPI 启动的、基于 Xen 的 hypervisor 时有效。Compute 服务只在镜像中包括一个分区，而且分区是 ext3 或 ext4 格式的情况下才会尝试重新调整分区大小。

true / false

XenAPI 驱动

os_type

在镜像中安装的操作系统。XenAPI 驱动中所包括的逻辑代码会根据镜像的 os_type 参数值的不同执行不同的操作。例如，设置为 os_type=windows 的镜像，它会创建一个基于 FAT32 的交换分区（swap partition），而不会创建 Linux 交换分区，它会限制其中的主机名的长度要小于 16 个字符。