openstack-manuals/doc/image-guide/source/image-formats.rst
Brian Rosmaita 9015ad6054 Update Image Guide for Newton
While updating the install guide, noticed two omissions in the
Image Guide:
- 'vhdx' disk_format was added in Newton with change
  I4e172c78d7afeb8be5a0123238efe3d8e4b044c9
- 'ova' container_format (was added a long time ago!)

Change-Id: I3bbc84023929da94c81806245987147b9757c43a
2016-09-15 18:34:37 -04:00

2.0 KiB

Disk and container formats for images

When you add an image to the Image service, you can specify its disk and container formats.

Disk formats

The disk format of a virtual machine image is the format of the underlying disk image. Virtual appliance vendors have different formats for laying out the information contained in a virtual machine disk image.

Set the disk format for your image to one of the following values:

aki

An Amazon kernel image.

ami

An Amazon machine image.

ari

An Amazon ramdisk image.

iso

An archive format for the data contents of an optical disc, such as CD-ROM.

qcow2

Supported by the QEMU emulator that can expand dynamically and supports Copy on Write.

raw

An unstructured disk image format; if you have a file without an extension it is possibly a raw format.

vdi

Supported by VirtualBox virtual machine monitor and the QEMU emulator.

vhd

The VHD disk format, a common disk format used by virtual machine monitors from VMware, Xen, Microsoft, VirtualBox, and others.

vhdx

The VHDX disk format, an enhanced version of the VHD format, which supports larger disk sizes among other features.

vmdk

Common disk format supported by many common virtual machine monitors.

Container formats

The container format indicates whether the virtual machine image is in a file format that also contains metadata about the actual virtual machine.

Note

The Image service and other OpenStack projects do not currently support the container format. It is safe to specify bare as the container format if you are unsure.

You can set the container format for your image to one of the following values:

aki

An Amazon kernel image.

ami

An Amazon machine image.

ari

An Amazon ramdisk image.

bare

The image does not have a container or metadata envelope.

docker

A docker container format.

ova

An OVF package in a tarfile.

ovf

The OVF container format.