OpenStack Image Management (Glance)
Go to file
Brian Waldon abcff5b5f5 Catch pruner exception when no images are cached
This handles a situation where the pruner would raise an exception when
the image_cache_max_size was set lower than the size of the last image.

Fixes bug 1039854

Change-Id: I4a6c164e9f821f1250314974f829f058fbd02863
2012-08-29 21:17:46 -07:00
bin Fix auth cred opts for glance-cache-manage 2012-08-17 11:23:51 -04:00
doc/source Merge "Rename glance api docs to something more concise" 2012-08-28 22:53:42 +00:00
etc Merge "Make max image size upload configurable" 2012-08-20 17:38:08 +00:00
glance Catch pruner exception when no images are cached 2012-08-29 21:17:46 -07:00
tools Add nosehtmloutput as a test dependency. 2012-08-22 17:24:05 -07:00
.coveragerc Fix coverage jobs. Also, clean up the tox.ini. 2012-06-04 15:29:26 -04:00
.gitignore Move to tag-based versioning. 2012-08-12 16:10:03 +00: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
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 Add glance/versioninfo to MANIFEST.in. 2012-08-23 08:56:05 -07:00
README.rst Few small cleanups to align with Nova 2012-01-25 11:14:51 -05:00
babel.cfg Added first step of babel-based translations. 2012-02-28 02:00:37 -08:00
openstack-common.conf Move to tag-based versioning. 2012-08-12 16:10:03 +00:00
pylintrc Packaging fixups 2010-10-21 15:51:44 -04:00
run_tests.sh Updates run_tests.sh to exclude openstack-common. 2012-07-13 14:10:56 -04:00
setup.cfg Fix coverage jobs. Also, clean up the tox.ini. 2012-06-04 15:29:26 -04:00
setup.py Move to tag-based versioning. 2012-08-12 16:10:03 +00:00
tox.ini Ignore openstack-common in pep8 check 2012-07-09 14:39:29 -07:00

README.rst

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.