glance/doc/source/architecture.rst
Vincent Untz e3151459e8 Fix typo in doc
metdata -> metadata

Change-Id: I44e5e73946e9d1a37b8e3a5974083e3fbea33d2d
2012-06-07 16:33:25 +02:00

74 lines
2.3 KiB
ReStructuredText

..
Copyright 2010 OpenStack, LLC
All Rights Reserved.
Licensed under the Apache License, Version 2.0 (the "License"); you may
not use this file except in compliance with the License. You may obtain
a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations
under the License.
Glance Architecture
===================
Glance is designed to be as adaptable as possible for various back-end storage
and registry database solutions. There is a main Glance API server
(the ``glance-api`` program) that serves as the communications hub between
various client programs, the registry of image metadata, and the storage
systems that actually contain the virtual machine image data.
From a birdseye perspective, one can visualize the Glance architectural model
like so:
.. graphviz::
digraph birdseye {
node [fontsize=10 fontname="Monospace"]
a [label="Client A"]
b [label="Client B"]
c [label="Client C"]
d [label="Glance API Server"]
e [label="Registry Server"]
f [label="Store Adapter"]
g [label="S3 Store"]
h [label="Swift Store"]
i [label="Filesystem Store"]
j [label="HTTP Store"]
a -> d [dir=both]
b -> d [dir=both]
c -> d [dir=both]
d -> e [dir=both]
d -> f [dir=both]
f -> g [dir=both]
f -> h [dir=both]
f -> i [dir=both]
f -> j [dir=both]
}
What is a Registry Server?
==========================
A registry server is a service that publishes image metadata for internal
consumption by the Glance API server. The Glance registry server uses a
SQL database for its metadata storage.
What is a Store?
================
A store is a Python class that inherits from ``glance.store.Backend`` and
conforms to that class' API for reading, writing, and deleting virtual
machine image data.
Glance currently ships with stores for S3, Swift, RBD, a simple filesystem store,
and a read-only HTTP(S) store.
Implementors are encouraged to create stores for other backends, including
other distributed storage systems like Sheepdog.