uca tracker #28

Supports: focal xenial bionic
Add to new model

Description

This charm tracks and publishes reports that compare Ubuntu Cloud Archive package versions for OpenStack. The charm generates an Nginx-based website and publishes reports to it.


Overview

This charm tracks and publishes reports that compare Ubuntu Cloud Archive package versions for OpenStack. The charm generates an Nginx-based website and publishes the reports to it. Reports can optionally be uploaded to swift.

There are two different version trackers:

  • Base version tracker: Compares package versions from Ubuntu archives only.
  • Upstream version tracker: Compares package versions from Ubuntu archives with the latest upstream versions.

Reports can optionally be uploaded to swift.

Reports are generated by server/cloud-archive/version-tracker/ from https://launchpad.net/ubuntu-reports.

Usage

juju deploy cs:~corey.bryant/uca-tracker

juju config uca-tracker base-tracker-releases='victoria ussuri train stein queens'

juju config uca-tracker upstream-tracker-releases='victoria ussuri train stein queens'

Once deployed, reports can be accessed at http://uca-tracker-IP-address.

Reports can optionally be uploaded to swift if an OpenStack client environment script is available on the unit at /home/ubuntu/openrc.

juju scp openrc uca-tracker/0:/home/ubuntu/openrc

Building

This is a layered charm. If you intend to make changes to the charm it must first be built with the charm build command before it can be used.

Notes

Reports for unsupported OpenStack will be generated but navigation links will not get published. This is a feature of the underlying ubuntu-reports tool that helps keep the navigation bar clean. Reports for unsupported releases will have to be accessed directly.

i.e. http://uca-tracker-IP-address/pike_versions.html


Configuration

base-tracker-releases
(string) The base version tracker reports package versions from Ubuntu, UCA-staging, UCA-proposed, and UCA-updates for each OpenStack release specified by this option. . If multiple OpenStack releases are to be tracked, they must be separated by spaces.
extra_packages
(string) Space separated list of extra deb packages to install.
host
(string) listen address
127.0.0.1
install_keys
(string) List of signing keys for install_sources package sources, per charmhelpers standard format (a yaml list of strings encoded as a string). The keys should be the full ASCII armoured GPG public keys. While GPG key ids are also supported and looked up on a keyserver, operators should be aware that this mechanism is insecure. null can be used if a standard package signing key is used that will already be installed on the machine, and for PPA sources where the package signing key is securely retrieved from Launchpad.
install_sources
(string) List of extra apt sources, per charm-helpers standard format (a yaml list of strings encoded as a string). Each source may be either a line that can be added directly to sources.list(5), or in the form ppa:<user>/<ppa-name> for adding Personal Package Archives, or a distribution component to enable.
package_status
(string) The status of service-affecting packages will be set to this value in the dpkg database. Valid values are "install" and "hold".
install
port
(int) NGINX listen port
80
upstream-tracker-releases
(string) The upstream version tracker reports package versions from Ubuntu, UCA-staging, UCA-proposed, UCA-updates, and the latest upstream version for each OpenStack release specified by this option. . If multiple OpenStack releases are to be tracked, they must be separated by spaces.