RETIRED, further work has moved to Debian project infrastructure
Go to file
Jay Pipes c713c22a25 Few small cleanups to align with Nova
* Adds HACKING.rst -- with some modifications that do not apply
  to Glance
* Renames README to README.rst
* Remove old cruft with rfc.sh and BZR stuff

Change-Id: I1ff640fcee71e4d9bafa28ddd83c779ac4d702d2
2012-01-25 11:14:51 -05:00
bin Merge "More flexible specification of auth credentials." 2012-01-24 20:32:15 +00:00
doc/source Adds documentation for policy files. 2012-01-24 21:19:26 -05:00
etc Add policy checking for basic image operations 2012-01-19 16:23:13 -08:00
glance Adds documentation for policy files. 2012-01-24 21:19:26 -05:00
tools Few small cleanups to align with Nova 2012-01-25 11:14:51 -05:00
.gitignore Rename .glance-venv to .venv. 2011-12-05 13:09:22 -08:00
.gitreview Add .gitreview config file for gerrit. 2011-10-24 11:02:16 -04:00
.mailmap Add policy checking for basic image operations 2012-01-19 16:23:13 -08:00
Authors Set correct Content-Length on cached remote images 2012-01-16 18:50:28 +00: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 Add missing files to tarball 2011-12-12 16:45:48 +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 Addresses glance/+spec/i18n 2011-08-10 09:09:56 -05:00
run_tests.sh Rename .glance-venv to .venv. 2011-12-05 13:09:22 -08:00
setup.cfg Added setup.py and sphinx docs. 2010-09-26 00:25:34 -07:00
setup.py Add missing files to tarball 2011-12-12 16:45:48 +01:00
tox.ini Add tox.ini file. 2011-12-30 14:03:15 -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.