openstack
/
glance
Code Issues Proposed changes
OpenStack Image Management (Glance)
937 Commits 10 Branches 46 Tags 126 MiB
Python 99.9%
Go to file
Brian Waldon 99b8a56259 Update registry db api to properly handle pagination through sorted results. 2011-08-02 18:38:20 +00:00
bin Replaced occurances of |str(e)| with |"%s" % e|. 2011-08-02 17:43:16 +00:00
doc Typo in error condition for create_bucket_on_put, make body seekable in req object, and remove +glance from docs and configs 2011-07-26 10:26:19 -04:00
etc Merge latest trunk 2011-07-28 19:01:40 -04:00
glance Update registry db api to properly handle pagination through sorted results. 2011-08-02 18:38:20 +00:00
tests Update registry db api to properly handle pagination through sorted results. 2011-08-02 18:38:20 +00:00
tools Make sure xattr>=0.6.0 in pip-requires 2011-08-01 11:42:58 -04: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 Add myself to Authors (again) 2011-07-29 16:02:46 +00: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 Installed nose-exclude, ./run_tests.sh --unittests-only add '--exclude-dir=tests/functional' to NOSEARGS 2011-07-30 00:12:44 -05:00
setup.cfg Added setup.py and sphinx docs. 2010-09-26 00:25:34 -07:00
setup.py Include bin/glance-scrubber in tarball binaries 2011-07-27 14:56:08 +02: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.