Juju Charm - Glance Simplestreams Sync
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Zuul cf1f8bf725 Merge "Dynamically generate proxy settings for image syncs" 2 weeks ago
actions Switch to using snap for simplestreams tools 1 year ago
charmhelpers c-h sync - restore proxy env vars for add-apt-repository 3 months ago
files Dynamically generate proxy settings for image syncs 2 weeks ago
hooks Dynamically generate proxy settings for image syncs 2 weeks ago
lib Update tox, requirements, add initial func tests framework 3 years ago
templates Dynamically generate proxy settings for image syncs 2 weeks ago
tests Test bundles for focal-wallaby and hirsute-wallaby 3 months ago
unit_tests Dynamically generate proxy settings for image syncs 2 weeks ago
.gitignore Update series metadata, test combos and readme 3 years ago
.gitreview OpenDev Migration Patch 2 years ago
.stestr.conf Replace ostestr with stestr in testing framework. 2 years ago
.zuul.yaml Switch to Ussuri jobs 2 years ago
HACKING.md Add doc pointing contributors to charm-guide 2 years ago
LICENSE Relicense to Apache2 3 years ago
Makefile Migrate from Amulet to Zaza 2 years ago
README.md Update README 12 months ago
actions.yaml Switch to using snap for simplestreams tools 1 year ago
charm-helpers-hooks.yaml Sync charm/ceph helpers, tox, and requirements 2 years ago
config.yaml Dynamically generate proxy settings for image syncs 2 weeks ago
copyright Update copyright date 3 years ago
metadata.yaml Add impish to metadata.yaml 2 months ago
osci.yaml Forward returncode from sync program 2 months ago
requirements.txt Sync release-tools 2 weeks ago
setup.cfg Initial baseline from bzr 4 years ago
test-requirements.txt Sync release-tools 2 weeks ago
tox.ini Sync release-tools 2 weeks ago

README.md

Overview

The glance-simplestreams-sync charm keeps OpenStack cloud images (in Glance) synchronised with the latest available images from a Simplestreams mirror(s). It uses Cron to do this.

The charm places simplestreams metadata in Object storage for future use by Juju. It then publishes the URL for that metadata as the endpoints of a new OpenStack service called 'product-streams'.

The charm installs Simplestreams from a snap.

Usage

Configuration

This section covers common and/or important configuration options. See file config.yaml for the full list of options, along with their descriptions and default values. See the Juju documentation for details on configuring applications.

run

The run option enables the synchronisation cron script. This option accepts Boolean values ('true' or 'false') with the default value being 'false'. Changing the value from 'false' to 'true' will immediately schedule an image sync.

Note: Enabling this option at cloud deploy time may cause a race condition with the set up of a possible storage backend for Glance.

frequency

The frequency option controls how often the sync cron job is run. It is used to link the cron script into /etc/cron.<frequency>. Valid string values are: 'hourly', 'daily', and 'weekly'. The default is 'daily'.

region

The region option states the OpenStack region to operate in. The default value is 'RegionOne'.

mirror_list

The mirror_list option is a YAML-formatted list of Simplestreams mirrors and their configuration properties. The default behaviour is to download images from https://cloud-images.ubuntu.com.

ssl_ca

The ssl_ca option verifies (optionally) the certificates when in SSL mode for Keystone and Glance. This should be provided as a base64 encoded PEM certificate.

Deployment

To deploy to an existing OpenStack cloud (that already includes Glance, Object storage, and Keystone):

juju deploy glance-simplestreams-sync
juju add-relation glance-simplestreams-sync:identity-service keystone:identity-service

Note: Charmed OpenStack commonly employs Ceph-backed Object storage (see the ceph-radosgw charm). Otherwise, a vanilla Swift-based solution can be used (see the swift-proxy charm).

Actions

Juju actions allow specific operations to be performed on a per-unit basis. This charm supports the single action sync-images, which allows for a one-time image sync from the currently configured mirror list.

Bugs

Please report bugs on Launchpad.

For general charm questions refer to the OpenStack Charm Guide.