Skip to main content

imgsync will download sync images from several distribution repositories and send them to an OpenStack Image service (Glance).

Project description

OpenStack Glance Image Synchronization tool

This application will download images from the official distribution repository, and upload them to OpenStack Glance. It is possible to define custom properties and prefixes for all the synced images.

Available distribution repositories

Currently the following images repositories are supported:

CentOS

Debian

Ubuntu

Installation

Install it via PyPI:

pip install imgsync

Or install it from the repo:

git clone https://github.com/alvarolopez/imgsync
pip install imgsync

Configuration

Copy /etc/imgsync/imgsync.conf.sample into /etc/imgsync/imgsync.conf and adjust it your your needs. Take into account the following:

  • You need to configure your OpenStack Keystone authentication under the [keystone_auth] section. The user should be able to publicize images in your glance deployment (check your policy file).

  • You can define a prefix to be used for all the distribution names with the prefix option.

  • Additionally you can add some custom image properties, using the properties option, that can be repeated multiple times for multiple properties.

  • The list of images to be downloaded is configured via the distributions option.

  • CentOS distributions define additional options to allow the download of all the published images, or just the latest one. This is configured in the [centos6] and [centos6] sections. This is not possible for Debian and Ubuntu.

Image properties

imgsync sets a property source=imgsync to all the images that donwloaded and synced. This way we can identify if an image is uploaded into glance by us or by anyone else. This property is hardcoded and cannot be reconfigured or replaced by something else. Other properties set by imgsync are are stored with the imgsync.prefix (like imgsync.sha256 or imgsync.sha512)

Nevertheless, it is also possible to define additional properties in the form "key=value" via the properties option in the configuration file (you can specify this option several times).

Therefore, it is important that you configure glance to enable the proper policy protection rules so that only the configured user is able to write those properties (i.e. at least source, imgsync.sha512 and imgsync.sha256). Moreover, you need to configure nova to exclude those properties when nova creates and uploads an snapshot to glance, via the non_inheritable_image_properties option in your /etc/nova/nova.conf configuration file (again, at least add source, imgsync.sha512 and imgsync.sha256).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for imgsync, version 1.1.3
Filename, size File type Python version Upload date Hashes
Filename, size imgsync-1.1.3-py2-none-any.whl (23.6 kB) File type Wheel Python version py2 Upload date Hashes View hashes
Filename, size imgsync-1.1.3-py3-none-any.whl (22.1 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size imgsync-1.1.3.tar.gz (16.4 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page