Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

附录 B. 镜像配置参数

您可以将以下键与 glance image-create 和 glance image-update 命令的 property 选项一起使用。

Expand
表 B.1. 属性键
特定于键描述支持的值

All

架构

管理程序必须支持的 CPU 架构。例如，x86_64、arm 或 ppc64。运行 uname -m 以获取计算机架构。

  • aarch - ARM 64 位
  • alpha - DEC 64 位 RISC
  • armv7l - ARM Cortex-A7 MPCore
  • CRIS- Ethernet, Token Ring, AXis-Code Reduced instructions Set
  • i686 - Intel 6th-generation x86（P6 微架构）
  • ia64 - Itanium
  • lm32 - Lattice Micro32
  • m68k - Motorola 68000
  • microblaze - Xilinx 32 位 FPGA (Big Endian)
  • microblazeel - Xilinx 32 位 FPGA (Little Endian)
  • M IPS - MIPS 32 位 RISC (Big Endian)
  • mipsel - MIPS 32 位 RISC (Little Endian)
  • mips64 - MIPS 64 位 RISC (Big Endian)
  • mips64el - MIPS 64 位 RISC (Little Endian)
  • openrisc - OpenCores RISC
  • Parisc - HP Precision Architecture RISC
  • parisc64 - HP Precision Architecture 64-bit RISC
  • ppc - PowerPC 32-bit
  • ppc64 - PowerPC 64-bit
  • ppcemb - PowerPC （嵌入式 32 位）
  • s390 - IBM Enterprise Systems Architecture/390
  • s390x - S/390 64-bit
  • sh4 - SuperH SH-4 (Little Endian)
  • sh4eb - SuperH SH-4 (Big Endian)
  • SPARC - 可扩展处理器架构, 32 位
  • sparc64 - 可扩展处理器架构, 64 位
  • unicore32 - Microprocessor research and Development Center RISC Unicore32
  • x86_64 - IA-32 的 64 位扩展
  • xtensa - Tensilica Xtensa 可配置微处理器内核
  • xtensaeb - Tensilica Xtensa 可配置微处理器内核(Big Endian)

All

hypervisor_type

管理程序类型。

KVM,vmware

All

instance_uuid

对于快照镜像，这是用于创建此镜像的服务器的 UUID。

有效的服务器 UUID

All

kernel_id

镜像服务中存储的镜像的 ID，在引导 AMI 风格的镜像时应用作内核。

有效的镜像 ID

All

os_distro

操作系统分发的通用名称（小写）。

  • arch - Arch Linux.不要使用 archlinux 或 org.archlinux。
  • CentOS - 社区企业操作系统.不要使用 org.centos 或 CentOS。
  • Debian - Debian.不要使用 Debian 或 org.debian。
  • Fedora - Fedora.不要使用 Fedora、org.fedora 或 org.fedoraproject。
  • FreeBSD - FreeBSD.不要使用 org.freebsd、freeBSD 或 FreeBSD。
  • gentoo - Gentoo Linux.不要使用 Gentoo 或 org.gentoo。
  • mandrake - Mandrakelinux (MandrakeSoft) distribution.不要使用 mandrakelinux 或 MandrakeLinux。
  • mandriva - Mandriva Linux.不要使用 mandrivalinux。
  • mes - Mandriva Enterprise Server.不要使用 mandrivaent 或 mandrivaES。
  • msdos - Microsoft Disc 操作系统.不要使用 ms-dos。
  • netbsd - NetBSD.不要使用 NetBSD 或 org.netbsd。
  • Netware - Novell NetWare.不要使用 novell 或 NetWare。
  • openbsd - OpenBSD.不要使用 OpenBSD 或 org.openbsd。
  • OpenSolaris - OpenSolaris.不要使用 OpenSolaris 或 org.open activities。
  • OpenSUSE - OpenSUSE.不要使用 suse、SuSE 或 org.opensuse。
  • rhel - Red Hat Enterprise Linux.不要使用 redhat、RedHat 或 com.redhat。
  • SLED - SUSE Linux Enterprise Desktop.不要使用 com.suse。
  • Ubuntu - Ubuntu.不要使用 Ubuntu、com.ubuntu、org.ubuntu 或 规范。
  • Windows - Microsoft Windows.不要使用 com.microsoft.server。

All

os_version

由经销商指定的操作系统版本。

版本号（例如："11.10"）

All

ramdisk_id

镜像服务中存储的镜像的 ID，在引导 AMI 风格的镜像时应用作 ramdisk。

有效的镜像 ID

All

vm_mode

虚拟机模式。这代表了用于虚拟机的主机/客户机 ABI （应用程序二进制接口）。

HVM- 完全虚拟化.这是 QEMU 和 KVM 使用的模式。

libvirt API 驱动程序

hw_cdrom_bus

指定要将 CD-ROM 设备附加到的磁盘控制器类型。

SCSI、virtio、ide 或 usb。如果指定了 iscsi，您必须将 hw_scsi_model 参数设置为 virtio-scsi。

libvirt API 驱动程序

hw_disk_bus

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

SCSI、virtio、ide 或 usb。请注意，如果使用 iscsi，则需要将 hw_scsi_model 设置为 virtio-scsi。

libvirt API 驱动程序

hw_firmware_type

指定用来引导实例的固件类型。

设置为以下有效值之一：

  • BIOS
  • uefi

libvirt API 驱动程序

hw_machine_type

启用使用指定的机器类型引导 ARM 系统。如果使用 ARM 镜像且其机器类型没有被明确指定，则 Compute 将使用 virt 机器类型作为 ARMv7 和 AArch64 的默认设置。

可以使用 virsh capabilities 命令查看有效的类型。机器类型显示在机器标签中。

libvirt API 驱动程序

hw_numa_nodes

要公开给实例的 NUMA 节点数（不覆盖类别定义）。

整数.

libvirt API 驱动程序

hw_numa_cpus.0

vCPU N-M 映射到 NUMA 节点 0 （不覆盖类别定义）。

以逗号分隔的整数列表。

libvirt API 驱动程序

hw_numa_cpus.1

vCPU N-M 映射到 NUMA 节点 1 （不覆盖类别定义）。

以逗号分隔的整数列表。

libvirt API 驱动程序

hw_numa_mem.0

将 N MB RAM 映射到 NUMA 节点 0 （不覆盖类别定义）。

整数

libvirt API 驱动程序

hw_numa_mem.1

将 N MB RAM 映射到 NUMA 节点 1 （不覆盖类别定义）。

整数

libvirt API 驱动程序

hw_pci_numa_affinity_policy

指定 PCI 透传设备和 SR-IOV 接口的 NUMA 关联性策略。

设置为以下有效值之一：

  • 必需 ：计算服务会创建一个实例，只有在实例的至少一个 NUMA 节点与 PCI 设备关联时才请求 PCI 设备。这个选项提供最佳性能。
  • preferred ：计算服务会尝试根据 NUMA 关联性选择 PCI 设备。如果关联性不可能，则计算服务会将实例调度到没有与 PCI 设备关联性的 NUMA 节点上。

  • 传统 ：（默认）计算服务创建请求 PCI 设备的实例：

    • PCI 设备与至少一个 NUMA 节点关联。
    • PCI 设备不提供有关其 NUMA 事务的信息。

libvirt API 驱动程序

hw_qemu_guest_agent

客户机代理支持。如果设置为 yes，并且安装了 qemu-ga，则可以静止(frozen)和快照自动创建。

是 / no

libvirt API 驱动程序

hw_rng_model

向使用此镜像启动的实例添加一个随机数生成器(RNG)设备。

instance 类别默认启用 RNG 设备。要禁用 RNG 设备，云管理员必须在类别上将 hw_rng:allowed 设置为 False。

默认熵源为 /dev/random。要指定硬件 RNG 设备，请在 Compute 环境文件中将 rng_dev_path 设置为 /dev/hwrng。

VirtIO 或其他支持的设备。

libvirt API 驱动程序

hw_scsi_model

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

virtio-scsi

libvirt API 驱动程序

hw_tpm_model

设置为要使用的 TPM 设备模型。如果没有配置 hw:tpm_version，则忽略。

  • TPM -tis: （默认） TPM 接口规格。
  • TPM-crb ：命令响应缓冲.仅与 TPM 版本 2.0 兼容。

libvirt API 驱动程序

hw_tpm_version

设置为要使用的 TPM 版本。TPM 版本 2.0 是唯一受支持的版本。

2.0

libvirt API 驱动程序

hw_video_model

在虚拟机实例中使用的显示设备的视频设备驱动程序。

设置为以下值之一以指定要使用的支持的驱动程序：

  • virtio - （默认）虚拟机显示设备 的建议 驱动程序，大多数架构支持。VirtIO GPU 驱动程序包含在 RHEL-7 及更高版本中，Linux 内核版本 4.4 及更新的版本。如果实例内核具有 VirtIO GPU 驱动程序，则实例可以使用所有 VirtIO GPU 功能。如果实例内核没有 VirtIO GPU 驱动程序，则 VirtIO GPU 设备会正常回退到 VGA 兼容模式，该模式为实例提供可正常工作的显示。
  • QXL - 已弃用 驱动程序的 Spice 或 noVNC 环境，这些环境不再被维护。
  • Cirrus - 传统驱动程序，仅支持向后兼容。不要将 用作新实例。
  • VGA - 将这个驱动程序用于 IBM Power 环境。
  • gop - 不支持 QEMU/KVM 环境。
  • Xen - KVM 环境不支持.
  • vmvga - 旧的驱动程序，不使用。
  • none - 使用这个值在单独配置驱动程序的虚拟 GPU (vGPU)实例中禁用模拟图形或视频。

libvirt API 驱动程序

hw_video_ram

视频镜像的最大 RAM。仅在类别 extra_specs 和该值高于 hw_video_ram 中设置的值时，才使用 hw_video:ram_max_mb 值。

以 MB 为单位的整数（例如 64）

libvirt API 驱动程序

hw_watchdog_action

启用在服务器挂起时执行指定操作的虚拟硬件 watchdog 设备。watchdog 使用 i6300esb 设备（模拟 PCI Intel 6300ESB）。如果没有指定 hw_watchdog_action，则禁用 watchdog。

  • disabled- 该设备没有附加。允许用户禁用镜像的 watchdog，即使它已使用镜像的类别启用。这个参数的默认值被禁用。
  • reset-Forcefully 重置 guest。
  • poweroff-Forcefully 关闭客户机。
  • 暂停客户机。
  • none-Only 启用 watchdog；如果服务器挂起，不执行任何操作。

libvirt API 驱动程序

os_command_line

libvirt 驱动程序使用的内核命令行，而不是默认值。对于 Linux 容器(LXC)，该值用作初始化的参数。这个密钥仅对 Amazon 内核、ramdisk 或机器镜像(aki、ari 或 ami)有效。

 

libvirt API 驱动程序

os_secure_boot

使用 创建通过 UEFI 安全引导保护的实例。

设置为以下有效值之一：

  • 必需 ：为使用此镜像启动的实例启用安全引导。只有计算服务找到可以支持安全引导的主机时，才会启动该实例。如果没有找到主机，Compute 服务会返回 "No valid host" 错误。
  • disabled ：为使用此镜像启动的实例禁用安全引导。默认禁用此选项。
  • 可选 ：只有在计算服务确定主机可以支持安全引导机制时，才会为使用此镜像启动的实例启用安全引导。

libvirt API 驱动程序和 VMware API 驱动程序

hw_vif_model

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

有效选项取决于配置的 hypervisor。

  • KVM 和 QEMU：e1000、ne2k_pci、pcnet、rtl8139 和 virtio。
  • VMware：e1000、e1000e、VirtualE1000e、VirtualE1000e、VirtualPCNet32, VirtualSriovEthernetCard 和 VirtualVmxnet.
  • Xen: e1000, netfront, ne2k_pci, pcnet, and rtl8139.

VMware API 驱动程序

vmware_adaptertype

管理程序使用的虚拟 SCSI 或 IDE 控制器。

lsiLogic、busLogic 或 ide

VMware API 驱动程序

vmware_ostype

描述镜像中安装的操作系统的 VMware GuestID。这个值在创建虚拟机时传递给虚拟机监控程序。如果没有指定，则密钥默认为 otherGuest。

如需更多信息，请参阅使用 VMware vSphere 的镜像。

VMware API 驱动程序

vmware_image_version

当前未使用。

1

XenAPI 驱动程序

auto_disk_config

如果为 true，则在实例引导前，磁盘上的根分区会自动调整大小。只有在使用带有 XenAPI 驱动程序的基于 Xen 的 hypervisor 时，Compute 服务才会考虑这个值。只有镜像上只有一个分区，并且仅当分区采用 ext3 或 ext4 格式时，计算服务才会尝试调整大小。

true / false

libvirt API 驱动程序和 XenAPI 驱动程序

os_type

在镜像上安装的操作系统。XenAPI 驱动程序包含根据镜像的 os_type 参数的值采取不同的操作的逻辑。例如，对于 os_type=windows 镜像，它会创建一个基于 FAT32 的交换分区，而不是 Linux swap 分区，它会将注入的主机名限制为小于 16 个字符。

linux 或 windows

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat