OpenStack Image Management (Glance)
Go to file
Thierry Carrez 1975f16933 Final versioning for Cactus 2011-04-14 22:03:01 +00:00
bin Updated properties should be marked as deleted=0. This allows previously deleted properties to be reactivated on an update. 2011-04-11 14:43:00 +00:00
doc OK, fix docs to make it clear that only the string 'true' is allowed for boolean headers. Add False-hood unit tests as well. 2011-04-12 17:45:16 -04:00
etc Updates glance-manage to use configuration files as well 2011-04-04 13:00:26 -04:00
glance Final versioning for Cactus 2011-04-14 22:03:01 +00:00
tests Removes capture of exception from eventlet in _upload_and_activate(), which catches the exceptions that come from the _safe_kill() method properly. 2011-04-13 22:07:59 +00:00
tools Adds ability for Swift to be used as a full-fledged backend. 2011-02-27 15:54:29 -05:00
.bzrignore Ignore build and deploy-related files 2011-02-04 12:45:27 -05:00
MANIFEST.in Add the migration sql scripts to MANIFEST.in. The gets them included in not only the tarball, but also by setup.py install. 2011-04-11 22:21:06 +02:00
README Removed glance-commit 2011-03-21 15:22:26 +03:00
builddeb.sh Packaging fixups 2010-10-21 15:51:44 -04:00
pylintrc Packaging fixups 2010-10-21 15:51:44 -04:00
run_tests.py Fixed run_tests.py addError() method since I noted it was faulty in another branch... 2011-03-16 12:30:09 -04:00
run_tests.sh Including tests/ in pep8 2011-02-05 01:40:39 -06:00
setup.cfg Added setup.py and sphinx docs. 2010-09-26 00:25:34 -07:00
setup.py Removed glance-commit 2011-03-21 15:22:26 +03:00

README

======
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 fetch from the bzr repo::

    bzr branch lp:glance


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-upload` tool to
register new images in Glance.

    glance-upload --type=machine --kernel=1 --ramdisk=2 myimage.img "MyImage"


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.