openstack
/
glance
Code Issues Proposed changes
OpenStack Image Management (Glance)
754 Commits 10 Branches 45 Tags 126 MiB
Python 99.9%
Go to file
Rick Harris 2c9c262163 Moving bin to image_cache/ 2011-07-22 10:57:53 -05:00
bin Moving bin to image_cache/ 2011-07-22 10:57:53 -05:00
doc updating client docs 2011-06-21 09:41:06 -04:00
etc Adding reaper script 2011-07-22 00:53:43 -05:00
glance Fixing comment 2011-07-22 01:02:56 -05:00
tests Reverts commit that did db migration during configure_db() and makes functional tests use in-memory database again. The issues we were seeing had to do with the timeout not being long enough when starting servers with disk-based registry databases and migrate taking too long when spinning up the registry server... this was shown in almost random failures of tests saying failure to start servers. Rather than increase the timeout from 3 seconds, I reverted the change that runs migrate on every startup and cut the total test duration down about 15 seconds. 2011-07-08 11:43:56 -04:00
tools Adding API call to query for cache entries 2011-07-12 04:09:36 -05:00
.bzrignore Update tests and .bzrignore to use tests.sqlite instead of glance.sqlite. 2011-04-20 14:08:04 -04:00
.mailmap adding Authors functionality; fixing one rogue pep8 violation 2011-04-27 11:00:49 -07:00
Authors updated Authors 2011-07-02 13:16:33 +09: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 merged glance trunk 2011-07-08 18:46:06 +09:00
run_tests.sh Update tests and .bzrignore to use tests.sqlite instead of glance.sqlite. 2011-04-20 14:08:04 -04:00
setup.cfg Added setup.py and sphinx docs. 2010-09-26 00:25:34 -07:00
setup.py Moving bin to image_cache/ 2011-07-22 10:57:53 -05: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.