Metadata-Version: 1.1
Name: imgsync
Version: 1.1.2
Summary: imgsync will download sync images from several distribution repositories and send them to an OpenStack Image service (Glance).
Home-page: http://github.com/alvarolopez/imgsync/
Author: Alvaro Lopez Garcia
Author-email: aloga@ifca.unican.es
License: UNKNOWN
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
        
        - CentOS 6: http://cloud.centos.org/centos/6/images/
        - CentOS 7: http://cloud.centos.org/centos/7/images/
        
        ### Debian
        
        - Debian 9: https://cdimage.debian.org/cdimage/openstack/current-9/
        - Debian testing: https://cdimage.debian.org/cdimage/openstack/testing/
        
        ### Ubuntu
        
        - Ubuntu 14.04: https://cloud-images.ubuntu.com/trusty/
        - Ubuntu 16.04: https://cloud-images.ubuntu.com/xenial/
        - Ubuntu 18.04: https://cloud-images.ubuntu.com/bionic/
        
        ## 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](https://docs.openstack.org/developer/glance/property-protections.html)
        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`).
        
        
Platform: UNKNOWN
Classifier: Environment :: OpenStack
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
