glance/doc/source/domain_implementation.rst

Glance domain model implementation

Gateway and basic layers

The domain model contains the following layers:

1. authorization
2. property
3. notifier
4. policy
5. quota
6. location
7. database

The schema below shows a stack that contains the Image domain layers and their locations:

Authorization

The first layer of the domain model provides a verification of whether an image itself or its property can be changed. An admin or image owner can apply the changes. The information about a user is taken from the request context and is compared with the image owner. If the user cannot apply a change, a corresponding error message appears.

Property protection

The second layer of the domain model is optional. It becomes available if you set the property_protection_file parameter in the Glance configuration file.

There are two types of image properties in Glance:

• Core properties, as specified in the image schema
• Meta properties, which are the arbitrary key/value pairs that can be added to an image

The property protection layer manages access to the meta properties through Glance’s public API calls. You can restrict the access in the property protection configuration file.

Notifier

On the third layer of the domain model, the following items are added to the message queue:

1. Notifications about all of the image changes
2. All of the exceptions and warnings that occurred while using an image

Policy

The fourth layer of the domain model is responsible for:

1. Defining access rules to perform actions with an image. The rules are defined in the etc/policy.json file.
2. Monitoring of the rules implementation.

Quota

On the fifth layer of the domain model, if a user has an admin-defined size quota for all of his uploaded images, there is a check that verifies whether this quota exceeds the limit during an image upload and save:

• If the quota does not exceed the limit, then the action to add an image succeeds.
• If the quota exceeds the limit, then the action does not succeed and a corresponding error message appears.

Location

The sixth layer of the domain model is used for interaction with the store via the glance_store library, like upload and download, and for managing an image location. On this layer, an image is validated before the upload. If the validation succeeds, an image is written to the glance_store library.

This sixth layer of the domain model is responsible for:

1. Checking whether a location URI is correct when a new location is added
2. Removing image data from the store when an image location is changed
3. Preventing image location duplicates

Database

On the seventh layer of the domain model:

• The methods to interact with the database API are implemented.
• Images are converted to the corresponding format to be recorded in the database. And the information received from the database is converted to an Image object.