Image metadataYou can associate metadata with an image using the --property
key=value
argument to glance image-create or glance
image-update. For
example:$glance image-update img-uuid --property architecture=arm --property hypervisor_type=qemu
If the following properties are set on an image, and the ImagePropertiesFilter scheduler
filter is enabled (which it is by default), then the scheduler will only consider
compute hosts that satisfy these properties:
architectureThe CPU architecture that must be supported by the hypervisor, e.g.
x86_64, arm, ppc64. Run
uname -m to get the architecture of a
machine. We strongly recommend using the architecture data vocabulary
defined by the libosinfo project
for this purpose. Recognized values for this field are:
alpha
DEC 64-bit RISC
armv7l
ARM Cortex-A7 MPCore
cris
Ethernet, Token Ring, AXis - Code Reduced Instruction Set
i686
Intel sixth-generation x86
(P6 microarchitecture)
ia64
Itanium
lm32
Lattice Micro32
m68k
Motorola 68000
microblaze
Xilinx 32-bit FPGA (Big Endian)
microblazeel
Xilinx 32-bit FPGA (Little Endian)
mips
MIPS 32-bit RISC (Big Endian)
mipsel
MIPS 32-bit RISC (Little Endian)
mips64
MIPS 64-bit 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 (Embedded 32-bit)
s390
IBM Enterprise Systems Architecture/390
s390x
S/390 64-bit
sh4
SuperH SH-4 (Little Endian)
sh4eb
SuperH SH-4 (Big Endian)
sparc
Scalable Processor Architecture, 32-bit
sparc64
Scalable Processor Architecture, 64-bit
unicore32
Microprocessor Research and Development Center
RISC Unicore32
x86_64
64-bit extension of IA-32
xtensa
Tensilica Xtensa configurable microprocessor core
xtensaeb
Tensilica Xtensa configurable microprocessor core
(Big Endian)
hypervisor_typeThe hypervisor type. Allowed values include: xen,
qemu, kvm,
lxc, uml,
vmware, hyperv,
powervm.vm_modeThe virtual machine mode. This represents the host/guest ABI
(application binary interface) used for the virtual machine. Allowed
values are:hvmFully virtualized. This is the mode used by QEMU and
KVM.xenXen 3.0 paravirtualized.umlUser Mode Linux paravirtualized.exeExecutables in containers. This is the mode used by
LXC.The following metadata properties are specific to the XenAPI driver:auto_disk_configA boolean option. If true, the root partition on the disk will be
automatically resized before the instance boots. This value is only
taken into account by the Compute service when using a Xen-based
hypervisor with the XenAPI driver. The Compute service will only attempt
to resize if there is a single partition on the image, and only if the
partition is in ext3 or ext4 format.os_typeThe operating system installed on the image, e.g.
linux, windows. The XenAPI
driver contains logic that will take different actions depending on the
value of the os_type parameter of the image. For example, for images
where os_type=windows, it will create a FAT32-based
swap partition instead of a Linux swap partition, and it will limit the
injected hostname to less than 16 characters.The following metadata properties are specific to
the libvirt API driver:
hw_video_modelThe video image driver used. Allowed
values include: vga,
cirrus,
vmvga, xen
and qxl.The following metadata properties are specific to the VMware API driver:
vmware_adaptertypeIndicates the virtual SCSI or IDE controller used by the hypervisor.
Allowed values: lsiLogic,
busLogic, idevmware_ostypeA VMware GuestID which describes the operating system installed in the
image. This will be passed to the hypervisor when creating a virtual
machine. See thinkvirt.com for a list of valid values. If this is not
specified, it will default to otherGuest.vmware_image_versionCurrently unused, set it to 1.
In order to assist end-users in utilizing images, you may wish to put additional
common metadata on Glance images. By community agreement, the following metadata
keys may be used across Glance installations for the purposes described below.
instance_uuid
For snapshot images, this is the UUID of the server used to create this image.
kernel_id
The ID of image stored in Glance that should be used as the kernel when
booting an AMI-style image.
ramdisk_id
The ID of image stored in Glance that should be used as the ramdisk when
booting an AMI-style image.
os_version
The operating system version as specified by the distributor.
os_distro
The value of this property is the common name of the operating system
distribution in all-lowercase. For this purpose, we use the same data
vocabulary as the libosinfo project. Following are the recognized values for
this property. In the interest of interoperability, please use only
a recognized value for this field. The deprecated values are listed
to assist you in searching for the recognized value. Allowed values
are:
arch
This is: Arch Linux
Do not use:
archlinux, or
org.archlinuxcentos
This is: Community Enterprise Operating System
Do not use:
org.centos, or
CentOSdebian
This is: Debian
Do not use:
Debian, or
org.debianfedora
This is: Fedora
Do not use:
Fedora,
org.fedora, or
org.fedoraprojectfreebsd
This is: FreeBSD
Do not use:
org.freebsd,
freeBSD, or
FreeBSDgentoo
This is: Gentoo Linux
Do not use:
Gentoo, or
org.gentoomandrake
This is: Mandrakelinux (MandrakeSoft)
Do not use:
mandrakelinux, or
MandrakeLinuxmandriva
This is: Mandriva Linux
Do not use:
mandrivalinuxmes
This is: Mandriva Enterprise Server
Do not use:
mandrivaent, or
mandrivaESmsdos
This is: Microsoft Disc Operating System
Do not use:
ms-dosnetbsd
This is: NetBSD
Do not use:
NetBSD, or
org.netbsdnetware
This is: Novell NetWare
Do not use:
novell, or
NetWareopenbsd
This is: OpenBSD
Do not use:
OpenBSD, or
org.openbsdopensolaris
Do not use:
OpenSolaris,or
org.opensolarisopensuse
This is: openSUSE
Do not use:
suse,
SuSE, or
org.opensuserhel
This is: Red Hat Enterprise Linux
Do not use:
redhat,
RedHat, or
com.redhatsled
This is: SUSE Linux Enterprise Desktop
Do not use:
com.suseubuntu
This is: Ubuntu
Do not use:
Ubuntu,
com.ubuntu,
org.ubuntu, or
canonicalwindows
This is: Microsoft Windows
Do not use:
com.microsoft.server, or
windoze