OpenStack Image Management (Glance)
Go to file
Bhuvan Arumugam f4ce37b9c2 Auto generate AUTHORS file for glance.
Bug: 976267

Now that git commits are gated by CLA, we shouldn't enforce
committers to add an entry in AUTHORS file. The AUTHORS file
should be generated automatically, based on git commits.

This commit fixes the problem.

* Authors
  Remove this file. To be consistent with other projects,
  the new file AUTHORS is generated automatically.

* .gitignore
  Add AUTHORS file.

* glance/common/setup.py
  generate_authors(): New method to create AUTHORS file. If
  AUTHORS.in file exists, append it's content to AUTHORS file.

* setup.py
  Import the new method.
  local_sdist.run(): Generate AUTHORS file before creating the
  package.

* MANIFEST.in
  s/Authors/AUTHORS

* glance/tests/unit/test_misc.py
  AuthorsTestCase: Remove this class that test an entry in
  Authors file.
  parse_mailmap(), str_dict_replace(): Remove these methods.

Change-Id: If83c3fe9b2142342ac11cc019bc24926f52ee753
2012-04-30 19:44:43 -07:00
bin Integrate openstack-common using update.py 2012-04-30 14:01:13 -07:00
doc/source Merge registry context with common context 2012-04-26 08:53:24 -07:00
etc Merge registry context with common context 2012-04-26 08:53:24 -07:00
glance Auto generate AUTHORS file for glance. 2012-04-30 19:44:43 -07:00
tools Integrate openstack-common using update.py 2012-04-30 14:01:13 -07:00
.gitignore Auto generate AUTHORS file for glance. 2012-04-30 19:44:43 -07:00
.gitreview Add .gitreview config file for gerrit. 2011-10-24 11:02:16 -04:00
.mailmap Updated RST docs on containers, fewer references to OVF format. 2012-04-02 12:03:16 -04:00
babel.cfg Added first step of babel-based translations. 2012-02-28 02:00:37 -08:00
HACKING.rst Integrate openstack-common using update.py 2012-04-30 14:01:13 -07:00
LICENSE Add a LICENSE file. 2012-01-03 10:14:01 -05:00
MANIFEST.in Auto generate AUTHORS file for glance. 2012-04-30 19:44:43 -07:00
openstack-common.conf Integrate openstack-common using update.py 2012-04-30 14:01:13 -07:00
pylintrc Packaging fixups 2010-10-21 15:51:44 -04:00
README.rst Few small cleanups to align with Nova 2012-01-25 11:14:51 -05:00
run_tests.py nose plugin to capture glance service logs 2012-03-16 21:18:05 +00:00
run_tests.sh Simplify pep8 output to one line per violation 2012-01-30 20:39:20 -08:00
setup.cfg Added first step of babel-based translations. 2012-02-28 02:00:37 -08:00
setup.py Auto generate AUTHORS file for glance. 2012-04-30 19:44:43 -07:00
tox.ini tox tests with run_tests.sh instead of nosetests 2012-03-19 22:37:41 +00: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 tool to register new images in Glance.

glance add name="My Image" < /path/to/my/image

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.