OpenStack Image Management (Glance)
Go to file
Eoghan Glynn 6873195cd1 Support zero-size image creation via the v1 API
Addresses LP 1025353 for the v1 API.

Transition image status to active immediately on creation
(as opposed to leaving it queued forever) if the size is set
to zero from the get-go.

The v2 implementation is left unchanged for now, as the image
status does not appear to ever transition from queued to active
in that case.

This change allows an image to be created that simply acts as
a properties bucket, but requires no image data. For example,
an image created from a booted-from-volume instance where only
the kernel, ramdisk ID, and block device mappings are required.

Change-Id: I61e96f3fe5f5245fec791170b4a8b4c72135c3de
2012-07-16 17:29:43 +01:00
bin Initial implementation of glance replication. 2012-07-10 11:26:36 -07:00
doc/source Support zero-size image creation via the v1 API 2012-07-16 17:29:43 +01:00
etc Reorganize context module 2012-07-10 08:31:50 -07:00
glance Support zero-size image creation via the v1 API 2012-07-16 17:29:43 +01:00
tools Update 'logging' imports to openstack-common 2012-07-12 15:59:26 -07:00
.coveragerc Fix coverage jobs. Also, clean up the tox.ini. 2012-06-04 15:29:26 -04:00
.gitignore Fix coverage jobs. Also, clean up the tox.ini. 2012-06-04 15:29:26 -04:00
.gitreview Add .gitreview config file for gerrit. 2011-10-24 11:02:16 -04:00
.mailmap Updated RST docs on containers, fewer references to OVF format. 2012-04-02 12:03:16 -04:00
babel.cfg Added first step of babel-based translations. 2012-02-28 02:00:37 -08:00
HACKING.rst Standardize logger instantiation 2012-06-25 08:27:08 -07:00
LICENSE Add a LICENSE file. 2012-01-03 10:14:01 -05:00
MANIFEST.in Include all tests in generated tarballs 2012-06-28 14:40:45 +02:00
openstack-common.conf Add openstack.common.log 2012-07-09 21:05:56 -07: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.sh Clean up .pyc files before running tests. 2012-06-19 12:07:12 -04:00
setup.cfg Fix coverage jobs. Also, clean up the tox.ini. 2012-06-04 15:29:26 -04:00
setup.py Add bin/glance-replicator to scripts in setup.py. 2012-07-10 18:31:25 -04:00
tox.ini Ignore openstack-common in pep8 check 2012-07-09 14:39:29 -07: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.