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

4.4. 镜像服务命令选项和属性

您可以将可选参数、属性和属性键与 openstack image create,glance image-create-via-import, 和 openstack image set 命令一起使用。

4.4.1. 镜像服务命令选项
复制链接

您可以将以下可选参数用于 openstack image create,glance image-create-via-import, 和 openstack image set 命令。

Expand
表 4.3. 命令选项
特定于选项描述

All

--architecture <ARCHITECTURE>

如 https://docs.openstack.org/glance/latest/user/common-image-properties.html#architecture中指定的操作系统架构

All

--protected [True_False]

如果为 true，则镜像将无法被删除。

All

--name <NAME>

镜像的描述性名称

All

--instance-uuid <INSTANCE_UUID>

可用于记录此镜像所关联的实例的元数据。（仅用于信息，不创建实例快照。）

All

--min-disk <MIN_DISK>

引导镜像所需的磁盘空间（以 GB 为单位）。

All

--visibility <VISIBILITY>

镜像可访问性范围。有效值： public, private, community, shared

All

--kernel-id <KERNEL_ID>

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

All

--os-version <OS_VERSION>

根据经销商指定的操作系统版本

All

--disk-format <DISK_FORMAT>

磁盘格式。有效值： none, ami, ari, aki, vhd, vhdx, vmdk, raw, qcow2, vdi, iso, ploop

All

--os-distro <OS_DISTRO>

如 https://docs.openstack.org/glance/latest/user/common-image-properties.html#os-distro中指定的操作系统分布的通用名称

All

--owner <OWNER>

镜像的所有者

All

--ramdisk-id <RAMDISK_ID>

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

All

--min-ram <MIN_RAM>

引导镜像所需的 RAM 量（以 MB 为单位）。

All

--container-format <CONTAINER_FORMAT>

容器的格式。有效值： none, ami, ari, aki, bare, ovf, ova, docker

All

--property <key=value>

与镜像关联的任意属性。可以多次使用。

OpenStack 镜像创建

--tags <TAGS> [<TAGS> ...]

与镜像相关的字符串列表

OpenStack 镜像创建

--id <ID>

镜像的标识符

OpenStack 镜像集

--remove-property

从镜像中删除的任意属性的密钥名称。

4.4.2. 镜像属性和属性键
复制链接

您可以将以下键与 的 property 选项一起使用，用于 openstack image create、glance image-create-via-import 和 openstack image set 命令。

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

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_tpm_model

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

  • TPM-tis ：（默认） TPM 接口规格。
  • TPM-crb: Command-Response Buffer.仅与 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 - Legacy 驱动程序，只支持向后兼容。不要将 用于新实例。
  • VGA - 将此驱动程序用于 IBM Power 环境。
  • bochs - 使用 UEFI 引导的实例使用此驱动程序。在某些情况下，您可以将这个驱动程序用于使用 BIOS 引导的实例，例如当实例不依赖于直接 VGA 硬件访问时。
  • 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_viommu_model

使用 Q35 机器类型的 x86 主机上的客户机添加虚拟 IOMMU 设备。

Intel,smmuv3,virtio,auto.默认值为 auto，它会自动选择 virtio。

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 driver

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

© 2026 Red Hat返回顶部