RETIRED, further work has moved to Debian project infrastructure

Go to file

Brian Waldon 743d3b230b Fix auth cred opts for glance-cache-manage The glance-cache-manage binary now supports the same auth env variables and flags as python-glanceclient. The old flag formats are still supported (but not documented) to support backwards- compatibility. Fixes bug 1038112 Change-Id: If9f15d030e3167f5c81ea275c0005c854cd94a40		2012-08-17 11:23:51 -04:00
bin	Fix auth cred opts for glance-cache-manage	2012-08-17 11:23:51 -04:00
doc/source	Move to tag-based versioning.	2012-08-12 16:10:03 +00:00
etc	Use container_format and disk_format as-is in v2	2012-08-10 14:09:49 -07:00
glance	Merge "Validate uuid-ness in v2 image entity"	2012-08-17 14:14:44 +00:00
tools	Move optional dependencies from pip-requires to test-requires	2012-07-31 18:14:42 -04: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
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	Move to tag-based versioning.	2012-08-12 16:10:03 +00: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	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.