Git-Ubuntu Operator

Git-Ubuntu Operator is a machine charm that deploys git-ubuntu.

Git-Ubuntu is a tool that generates and updates git repositories associated with packages in Ubuntu, providing developers with a git-based package maintenance solution.

Architecture

The Git-Ubuntu Operator maintains units with the following architecture:

Getting started

Deploy the git-ubuntu importer using juju deploy git-ubuntu --num-units 2.

You can additionally scale up the number of workers by increasing the number of units in --num-units. The leader unit will contain the poller and broker processes, and all others will contain only worker processes.

Secrets

A Launchpad auth token and SSH private key can be provided together to git-ubuntu via the lpuser_secret_id config entry.

Launchpad Key

An API token is required to gather data from Launchpad. It is included with juju add-secret lpuser-secret-id lpkey=/path/to/lpkey_file. It is easiest to generate it using the ppa-dev-tools snap, which has an option to create the file directly:

snap install ppa-dev-tools
ppa credentials

This will generate a link to set up the key. Its contents will then be generated in the file credentials.oauth.

SSH Key

If the importer needs to be set up to publish to launchpad, an SSH secret key associated with lpuser is required. It can be included with juju add-secret lpuser-secret-id sshkey=/path/to/ssh_key

Contributing

Please see the Juju SDK docs for guidelines on enhancements to this charm following best practice guidelines, and CONTRIBUTING.md for developer guidance.

License

git-ubuntu-operator is free software, distributed under the Apache Software License, version 2.0. See LICENSE for more information.