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

附录 B. 镜像配置参数

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

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

All

架构

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

  • aarch - ARM 64-bit
  • alpha - DEC 64 位 RISC
  • armv7l - ARM Cortex-A7 MPCore
  • CRIS- Ethernet, Token Ring, AXis-Code Reduced instructions Set
  • i686 - Intel 6th-generation x86（P6 微架构）
  • ia 64- 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-bit 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 位
  • sh4- SuperH SH-4 (Little Endian)
  • sh4eb - SuperH SH-4 (Big Endian)
  • SPARC- Scalable Processor 架构, 32 位
  • sparc64- Scalable Processor Architecture, 64-bit
  • unicore32- Microprocessor Research and Development Center RISC Unicore32
  • X86_64- 64-bit 扩展 IA-32
  • 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

小写的操作系统分布的通用名称。

  • 存档 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)发行版.不要使用 mandrakelinux 或 MandrakeLinux。
  • mandriva - Mandriva Linux.不要使用 mandrivalinux。
  • mes - Mandriva Enterprise Server.不要使用 mandrivaent 或 mandrivaES。
  • msdos - Microsoft Disc Operating System.不要使用 ms-dos。
  • netbsd - NetBSD.不要使用 NetBSD 或 org.netbsd。
  • Netware- Novell NetWare.不要使用 novell 或 NetWare。
  • openbsd - OpenBSD。不要使用 OpenBSD 或 org.openbsd。
  • OpenSolaris - OpenSolaris.不要使用 Open swig 或 org.open migration。
  • 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

虚拟机模式。这代表了用于虚拟机的主机/guest 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)设备。

实例类别默认启用 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_video_model

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

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

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

libvirt API 驱动程序

hw_video_ram

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

以 MB 为单位的整数( 例如64)

libvirt API 驱动程序

hw_watchdog_action

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

  • Disabled - 设备没有附加。允许用户禁用镜像的 watchdog，即使已使用镜像的类别启用了它。这个参数的默认值被禁用。
  • 重置客户机。
  • poweroff-Forcefully 关闭客户机。
  • 暂停 guest。
  • 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" 错误。
  • 禁用 ：为使用此镜像启动的实例禁用安全引导。默认禁用此选项。
  • 可选 ：仅在计算服务决定主机可以支持安全引导时，为使用此镜像启动的实例启用安全引导。

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

hw_vif_model

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

有效选项取决于配置的虚拟机监控程序。

  • KVM 和 QEMU：e1000、ne2k_pci、pcnet、rtl8139 和 virtio.
  • VMware：e1000、e1000e、VirtualE1000、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 时，计算服务才会考虑该值。只有映像上只有一个分区，并且仅当分区采用 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, Inc.