OpenStack Image Management (Glance)
Go to file
Jay Pipes 72e2e31fea Add @skip_if_disabled decorator to test.utils and integrate
it into the base functional API test case. The S3 functional
test case now uses test_api.TestApi as its base class and
the setUp() method sets the disabled and disabled_message
attributes that the @skip_if_disabled decorator uses.

The S3 test case now tests all the methods that are tested
for the filesystem store driver in test_api.TestApi

Removed the test.functional.test_s3.conf file as it was no
longer needed.

Change-Id: I308d7a655c8c26339d0e2560634421935bbc8b5d
2011-08-08 12:56:30 -04:00
bin merging trunk 2011-08-02 17:10:33 -04:00
doc adding sort_key/sort_dir to details 2011-08-01 20:23:06 -04:00
etc Adds swift_enable_snet config 2011-08-05 11:54:52 -05:00
glance Add @skip_if_disabled decorator to test.utils and integrate 2011-08-08 12:56:30 -04:00
tools Detect python version in install_venv 2011-08-05 01:16:00 -05:00
.bzrignore Update tests and .bzrignore to use tests.sqlite instead of glance.sqlite. 2011-04-20 14:08:04 -04:00
.gitignore Add @skip_if_disabled decorator to test.utils and integrate 2011-08-08 12:56:30 -04:00
.mailmap adding Authors functionality; fixing one rogue pep8 violation 2011-04-27 11:00:49 -07:00
Authors Add myself to Authors (again) 2011-07-29 16:02:46 +00:00
builddeb.sh Packaging fixups 2010-10-21 15:51:44 -04:00
MANIFEST.in Move tests under the glance namespace. 2011-08-03 00:10:52 +02:00
pylintrc Packaging fixups 2010-10-21 15:51:44 -04:00
README Changed setup.py to pull version info from git. 2011-08-04 08:51:04 -07:00
run_tests.py Implemented @utils.skip_test, @utils.skip_unless and @utils.skip_if functionality in glance/test/utils.py. Added glance/tests/unit/test_skip_examples.py which contains example skip case usages. 2011-08-04 11:39:14 -05:00
run_tests.sh Fixes bug lp:821296 2011-08-05 09:49:03 -05:00
setup.cfg Added setup.py and sphinx docs. 2010-09-26 00:25:34 -07:00
setup.py Changed setup.py to pull version info from git. 2011-08-04 08:51:04 -07: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-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.