OpenStack Image Management (Glance)
Go to file
Russell Bryant db2942166d Add a LICENSE file.
The license file was missing in glance. The LICENSE file added here is
copied in from nova.

Change-Id: Ifae7610ea2c4d0db9cb4fc58a5639850f2b3e195
2012-01-03 10:14:01 -05:00
bin Merge "Adds support for protecting images from accidental deletion." 2011-12-27 16:37:37 +00:00
doc Synchronize notification queue setup between nova and glance 2011-12-29 00:03:19 +00:00
etc Synchronize notification queue setup between nova and glance 2011-12-29 00:03:19 +00:00
glance Bug #909538: Swift upload via Glance logs the password it's using 2012-01-01 10:41:50 -08:00
tools Lock keystone to specific commit in pip-requires 2011-12-08 13:56:32 -05:00
.bzrignore Rename .glance-venv to .venv. 2011-12-05 13:09:22 -08: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 Rename .glance-venv to .venv. 2011-12-05 13:09:22 -08:00
Authors Add a LICENSE file. 2012-01-03 10:14:01 -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
README Removing glance-upload 2011-10-25 22:11:38 -04:00
pylintrc Packaging fixups 2010-10-21 15:51:44 -04: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

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 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.