openstack/glance
Code Issues Proposed changes
OpenStack Image Management (Glance)
418 Commits 11 Branches 54 Tags 130 MiB
Python 99.9%
3716d83995
Go to file
jaypipes@gmail.com 3716d83995 Allow someone to set the GLANCE_TEST_MIGRATIONS_CONF environment 
variable to override the config file to run for the migrations
unit test:

pipes@serialcoder:~/repos/glance/bug730213$ GLANCE_TEST_MIGRATIONS_CONF=/tmp/glance_test_migrations.conf ./run_tests.sh -V tests.unit.test_migrations
TestMigrations
    test_no_data_loss_2_to_3_to_2                               OK
        test_walk_versions                                          OK

        ----------------------------------------------------------------------
        Ran 2 tests in 2.744s

This will make Monty happy so that Hudson can test more than just SQLite...
2011-03-24 15:31:30 -04:00
bin Bug #737979: glance-control uses fixed path to Python interpreter, breaking virtualenv 2011-03-19 03:03:46 +00:00
doc Merge trunk and resolve conflict 2011-03-16 12:11:56 -04:00
etc Put account in glance.conf.sample's swift_store_auth_address, use real swift.common.client.ClientException, ensure tests work with older installed versions of Swift (which do not have, for example, swift.common.client.Connection.get_auth method) 2011-03-04 19:02:26 -05:00
glance OK, migrations are finally under control and properly tested. 2011-03-23 09:45:11 -04:00
tests Allow someone to set the GLANCE_TEST_MIGRATIONS_CONF environment 2011-03-24 15:31:30 -04:00
tools Adds ability for Swift to be used as a full-fledged backend. 2011-02-27 15:54:29 -05:00
.bzrignore Ignore build and deploy-related files 2011-02-04 12:45:27 -05:00
builddeb.sh Packaging fixups 2010-10-21 15:51:44 -04:00
MANIFEST.in Use Nova's path trick in all bins... 2011-02-21 17:11:27 -05:00
pylintrc Packaging fixups 2010-10-21 15:51:44 -04:00
README Removing dubious advice 2011-02-05 19:36:05 -06:00
run_tests.py Fixed run_tests.py addError() method since I noted it was faulty in another branch... 2011-03-16 12:30:09 -04:00
run_tests.sh Including tests/ in pep8 2011-02-05 01:40:39 -06:00
setup.cfg Added setup.py and sphinx docs. 2010-09-26 00:25:34 -07:00
setup.py Adds bin/glance to setup.py 2011-03-01 01:38:34 -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-combined` utility which runs both the
`glance-api` and `glance-registry` services::

    glance-combined


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.