OpenStack Image Management (Glance)
Go to file
Mark McLoughlin ba44d1c384 Add generic PasteDeploy app and filter factories
These generic factories allow us to dump the copied and pasted
app_factory and filter_factory methods in the codebase.

The main difference is the paste configuration changes from:

  [app:apiv1app]
  paste.app_factory = glance.api.v1:app_factory
  ...
  [filter:cache]
  paste.filter_factory = glance.api.middleware.cache:filter_factory

to this:

  [app:apiv1app]
  paste.app_factory = glance.common.wsgi:app_factory
  glance.app_factory = glance.api.v1:API
  ...
  [filter:cache]
  paste.filter_factory = glance.common.wsgi:filter_factory
  glance.filter_factory = glance.api.middleware.cache:CacheFilter

Apart from reducing code duplication, this will also allow us to have
the generic factories inject other data into the apps and filters.

Change-Id: I1d2be5630ab61d29b8948ff88d58e6e1b11c2e5f
2011-12-07 12:42:03 +00:00
bin Add --url option to glance cli. 2011-12-02 12:25:57 +00:00
doc Add generic PasteDeploy app and filter factories 2011-12-07 12:42:03 +00:00
etc Add generic PasteDeploy app and filter factories 2011-12-07 12:42:03 +00:00
glance Add generic PasteDeploy app and filter factories 2011-12-07 12:42:03 +00:00
tools Rename .glance-venv to .venv. 2011-12-05 13:09:22 -08: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 Rename .glance-venv to .venv. 2011-12-05 13:09:22 -08:00
MANIFEST.in Fixes Bug #851216 2011-09-16 13:49:52 -04:00
pylintrc Packaging fixups 2010-10-21 15:51:44 -04:00
README Removing glance-upload 2011-10-25 22:11:38 -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 Merge "Adds Driver Layer to Image Cache" 2011-10-26 17:01:27 +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.