OpenStack Image Management (Glance)
Go to file
Brian Waldon 5182c1eb21 API v2 controller/serialization separation
* images and access are now separated into deserializers, controllers, and serializers
* now using schemas to valide incoming requests
* adding create methods for image access
* removing ImageNotFound as it was only being generated by fakes, using NotFound until the backend is updated

Change-Id: Ida3c1b117ee0147e818b74518e84ef9101cbdfc3
2012-04-11 09:15:18 -07:00
bin Merge "Allow specifying the current version in 'glance-manage version_control'" 2012-03-29 22:18:34 +00:00
doc/source Minor grammar corrections. 2012-04-10 12:54:12 -07:00
etc Reorganize pipelines for multiple api versions 2012-04-05 08:52:12 -07:00
glance API v2 controller/serialization separation 2012-04-11 09:15:18 -07:00
tools API v2 controller/serialization separation 2012-04-11 09:15:18 -07: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 Updated RST docs on containers, fewer references to OVF format. 2012-04-02 12:03:16 -04:00
Authors Minor grammar corrections. 2012-04-10 12:54:12 -07:00
babel.cfg Added first step of babel-based translations. 2012-02-28 02:00:37 -08: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 Include babel.cfg and glance.pot in tarballs 2012-03-15 14:05:01 +01: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 nose plugin to capture glance service logs 2012-03-16 21:18:05 +00:00
run_tests.sh Simplify pep8 output to one line per violation 2012-01-30 20:39:20 -08:00
setup.cfg Added first step of babel-based translations. 2012-02-28 02:00:37 -08:00
setup.py Remove glance-cache-queue-image 2012-03-15 14:26:59 -07:00
tox.ini tox tests with run_tests.sh instead of nosetests 2012-03-19 22:37:41 +00: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.