Skip to content
The Glance project provides services for discovering, registering, and retrieving virtual machine images. Glance has a RESTful API that allows querying of VM image metadata as well as retrieval of the actual image.
Python Other
Pull request Compare This branch is 53 commits ahead, 4047 commits behind openstack:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
bin
doc
etc
glance
redhat
tools
.bzrignore
.gear-rules
.gitignore
.gitreview
.mailmap
Authors
LICENSE
MANIFEST.in
README
builddeb.sh
openstack-glance.spec
pylintrc
run_tests.py
run_tests.sh
setup.cfg
setup.py

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 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.
Something went wrong with that request. Please try again.