OpenStack Image Management (Glance)
Go to file
Eoghan Glynn 5835b30cc2 Avoid the need for users to manually edit PasteDeploy config in order to switch pipelines.
Define multiple pipelines in glace-api.conf to reflect the
various supported deployment flavors (minimal, with caching,
with cache management, with keystone-based auth etc.).

Add an optional paste_deploy.flavor config variable to allow the
user select the appropriate pipeline without having to edit the
paste config (i.e. uncommenting lines as before). For example
in glance-api.conf, a setting of:

  [paste_deploy]
  flavor = keystone+caching

identifies the following pipeline in glace-api-paste.ini:

  [pipeline:glance-api-keystone+caching]
  pipeline = versionnegotiation authtoken auth-context cache apiv1app

the advantage being that the user need not be concerned with
the precise sequence of filters required to realize the QoS
they desire.

Modify the functional tests that patch configuration (i.e. the
keystone and caching tests) to use the new deployment_flavor
mechanism.

Extend the TestConfigOpts to support option groups.

Change-Id: Ide843ada11bce115b7dc650440397853c6409b03
2012-01-17 12:00:33 +00:00
bin Merge "fix bug 911681" 2012-01-05 02:48:23 +00:00
doc/source Avoid the need for users to manually edit PasteDeploy config in order to switch pipelines. 2012-01-17 12:00:33 +00:00
etc Avoid the need for users to manually edit PasteDeploy config in order to switch pipelines. 2012-01-17 12:00:33 +00:00
glance Avoid the need for users to manually edit PasteDeploy config in order to switch pipelines. 2012-01-17 12:00:33 +00:00
tools Install an actual good version of pip. 2012-01-02 13:28:15 -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 Implement retries in notify_kombu 2012-01-12 23:49:41 -08: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 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 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.