OpenStack Image Management (Glance)
Go to file
Eoghan Glynn 62c913c3ad Require container & disk formats on image create
Fixes lp 933702

For images created via the glance CLI, the container and disk formats
were previously defaulted if not explicitly set. However if created via
the python or REST APIs, these attributes were not defaulted if unset.

There is no real sensible default for these formats, so now an image
create fails with 400 "Bad Request" if the format metadata are missing.

Also we ensure unset image metadata are not reported in x-image-meta-*
headers in order to disambiguate None and empty string values.

Change-Id: I8189383f5f9adf42a8cdac7f8dc7e9327baf46da
2012-02-20 18:06:51 +00:00
bin Require container & disk formats on image create 2012-02-20 18:06:51 +00:00
doc/source Require container & disk formats on image create 2012-02-20 18:06:51 +00:00
etc Implement blueprint add-qpid-support. 2012-02-10 15:36:13 -05:00
glance Require container & disk formats on image create 2012-02-20 18:06:51 +00:00
tools Support non-UTC timestamps in changes-since filter 2012-02-17 20:17:38 +00:00
.gitignore Prep tox config for jenkins builds. 2012-02-06 08:31:49 -08:00
.gitreview Add .gitreview config file for gerrit. 2011-10-24 11:02:16 -04:00
.mailmap Adds README.rst to the tarball. 2012-02-17 11:56:11 -05:00
Authors Adds README.rst to the tarball. 2012-02-17 11:56:11 -05:00
HACKING.rst Few small cleanups to align with Nova 2012-01-25 11:14:51 -05:00
LICENSE Add a LICENSE file. 2012-01-03 10:14:01 -05:00
MANIFEST.in Adds README.rst to the tarball. 2012-02-17 11:56:11 -05:00
pylintrc Packaging fixups 2010-10-21 15:51:44 -04:00
README.rst Few small cleanups to align with Nova 2012-01-25 11:14:51 -05:00
run_tests.py Addresses glance/+spec/i18n 2011-08-10 09:09:56 -05:00
run_tests.sh Simplify pep8 output to one line per violation 2012-01-30 20:39:20 -08:00
setup.cfg Prep tox config for jenkins builds. 2012-02-06 08:31:49 -08:00
setup.py Add missing files to tarball 2011-12-12 16:45:48 +01:00
tox.ini Add a generic tox build environment. 2012-02-10 23:39:30 -08:00

Glance

Glance is a project that defines services for discovering, registering, retrieving and storing virtual machine images. The discovery and registration responsibilities are handled by the glance-registry component while the retrieval and storage responsiblities are handled by the glance-api component.

Quick Start

If you'd like to run trunk, you can clone the git repo:

git clone git@github.com:openstack/glance.git

Install Glance by running:

python setup.py build
sudo python setup.py install

By default, glance-registry will use a SQLite database. If you'd like to use MySQL, or make other adjustments, you can modify the glance.cnf file (see documentation for more details).

Now that Glance is installed, you can start the service. The easiest way to do that is by using the glance-control utility which runs both the glance-api and glance-registry services:

glance-control all start

Once both services are running, you can now use the glance tool to register new images in Glance.

glance add name="My Image" < /path/to/my/image

With an image registered, you can now configure your IAAS provider to use Glance as its image service and begin spinning up instances from your newly registered images.