965e2c3594
An OVA package is a tar archive usually containing an OVF directory inside it. Nova needs to be able to differentiate OVF and OVA based on the container format in order to extract the relevant information from it. This patch adds the OVA container format to the Glance configuration. Closes-Bug: #1286375 Change-Id: I5034d2943907823a9296e7a5fb41a28f2d92ec5a
109 lines
3.0 KiB
ReStructuredText
109 lines
3.0 KiB
ReStructuredText
..
|
|
Copyright 2011 OpenStack Foundation
|
|
All Rights Reserved.
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
not use this file except in compliance with the License. You may obtain
|
|
a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
License for the specific language governing permissions and limitations
|
|
under the License.
|
|
|
|
Disk and Container Formats
|
|
==========================
|
|
|
|
When adding an image to Glance, you must specify what the virtual
|
|
machine image's *disk format* and *container format* are. Disk and container
|
|
formats are configurable on a per-deployment basis. This document intends to
|
|
establish a global convention for what specific values of *disk_format* and
|
|
*container_format* mean.
|
|
|
|
Disk Format
|
|
-----------
|
|
|
|
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.
|
|
|
|
You can set your image's disk format to one of the following:
|
|
|
|
* **raw**
|
|
|
|
This is an unstructured disk image format
|
|
|
|
* **vhd**
|
|
|
|
This is the VHD disk format, a common disk format used by virtual machine
|
|
monitors from VMWare, Xen, Microsoft, VirtualBox, and others
|
|
|
|
* **vmdk**
|
|
|
|
Another common disk format supported by many common virtual machine monitors
|
|
|
|
* **vdi**
|
|
|
|
A disk format supported by VirtualBox virtual machine monitor and the QEMU
|
|
emulator
|
|
|
|
* **iso**
|
|
|
|
An archive format for the data contents of an optical disc (e.g. CDROM).
|
|
|
|
* **qcow2**
|
|
|
|
A disk format supported by the QEMU emulator that can expand dynamically and
|
|
supports Copy on Write
|
|
|
|
* **aki**
|
|
|
|
This indicates what is stored in Glance is an Amazon kernel image
|
|
|
|
* **ari**
|
|
|
|
This indicates what is stored in Glance is an Amazon ramdisk image
|
|
|
|
* **ami**
|
|
|
|
This indicates what is stored in Glance is an Amazon machine image
|
|
|
|
Container Format
|
|
----------------
|
|
|
|
The container format refers to whether the virtual machine image is in a
|
|
file format that also contains metadata about the actual virtual machine.
|
|
|
|
Note that the container format string is not currently used by Glance or
|
|
other OpenStack components, so it is safe to simply specify **bare** as
|
|
the container format if you are unsure.
|
|
|
|
You can set your image's container format to one of the following:
|
|
|
|
* **bare**
|
|
|
|
This indicates there is no container or metadata envelope for the image
|
|
|
|
* **ovf**
|
|
|
|
This is the OVF container format
|
|
|
|
* **aki**
|
|
|
|
This indicates what is stored in Glance is an Amazon kernel image
|
|
|
|
* **ari**
|
|
|
|
This indicates what is stored in Glance is an Amazon ramdisk image
|
|
|
|
* **ami**
|
|
|
|
This indicates what is stored in Glance is an Amazon machine image
|
|
|
|
* **ova**
|
|
|
|
This indicates what is stored in Glance is an OVA tar archive file
|