fea599efcc
Updated the RST documentation that discusses container formats, since they aren't really used right now. Changed some examples from ovf to bare, since in most cases, users just upload a bare image file. Change-Id: I844d7827c3de4df6cdddb9b963cc2f236a3e6767
104 lines
2.8 KiB
ReStructuredText
104 lines
2.8 KiB
ReStructuredText
..
|
|
Copyright 2011 OpenStack, LLC
|
|
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 are may specify what the virtual
|
|
machine image's *disk format* and *container format* are.
|
|
|
|
This document explains exactly what these formats are.
|
|
|
|
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 container 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
|