Ansible Galaxy proxy using Artifactory as a backend
Project description
galactory
galactory is An Ansible Galaxy proxy for Artifactory.
Using an Artifactory Generic repository as its backend, galactory implements a limited subset of the Galaxy v2 API to allow for installing and publishing collections.
It can also be set up to transparently proxy an upstream Galaxy server, storing the pulled artifacts in Artifactory, to be served as local artifacts from then on. This helps avoid throttling errors on busy CI systems, and allows for internal/private collections to declare dependencies on upstream collections (dependencies will only be installed from the same Galaxy server where a collection was installed from).
Acknowledgements
This project is heavily inspired by amanda.
How to use
There isn't any proper documentation yet. The help output is below.
Pulling out this bit about configuration for emphasis:
Args that start with
--
(eg.--listen-addr
) can also be set in a config file (/etc/galactory.d/*.conf
or~/.galactory/*.conf
or specified via-c
). Config file syntax allows:
key=value
flag=true
stuff=[a,b,c]
(for details, seeDefaultConfigFileParser
syntax at https://github.com/bw2/ConfigArgParse#config-file-syntax).If an arg is specified in more than one place, then commandline values override environment variables which override config file values which override defaults.
defaults < config < environment variables < command line
(last one found wins)
usage: python -m galactory [-h] [-c CONFIG] [--listen-addr LISTEN_ADDR]
[--listen-port LISTEN_PORT] [--server-name SERVER_NAME]
--artifactory-path ARTIFACTORY_PATH
[--artifactory-api-key ARTIFACTORY_API_KEY] [--use-galaxy-key]
[--prefer-configured-key] [--log-file LOG_FILE]
[--log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL}] [--log-headers]
[--log-body] [--proxy-upstream PROXY_UPSTREAM]
[-npns NO_PROXY_NAMESPACE]
galactory is a partial Ansible Galaxy proxy that uploads and downloads collections, using an
Artifactory generic repository as its backend.
optional arguments:
-h, --help show this help message and exit
-c CONFIG, --config CONFIG
The path to a config file. [env var: GALACTORY_CONFIG]
--listen-addr LISTEN_ADDR
The IP address to listen on. [env var: GALACTORY_LISTEN_ADDR]
--listen-port LISTEN_PORT
The TCP port to listen on. [env var: GALACTORY_LISTEN_PORT]
--server-name SERVER_NAME
The host name and port of the server, as seen from clients. Used for
generating links. [env var: GALACTORY_SERVER_NAME]
--artifactory-path ARTIFACTORY_PATH
The URL of the path in Artifactory where collections are stored. [env var:
GALACTORY_ARTIFACTORY_PATH]
--artifactory-api-key ARTIFACTORY_API_KEY
If set, is the API key used to access Artifactory. [env var:
GALACTORY_ARTIFACTORY_API_KEY]
--use-galaxy-key If set, uses the Galaxy token as the Artifactory API key. [env var:
GALACTORY_USE_GALAXY_KEY]
--prefer-configured-key
If set, prefer the confgured Artifactory key over the Galaxy token. [env
var: GALACTORY_PREFER_CONFIGURED_KEY]
--log-file LOG_FILE If set, logging will go to this file instead of the console. [env var:
GALACTORY_LOG_FILE]
--log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL}
The desired logging level. [env var: GALACTORY_LOG_LEVEL]
--log-headers Log the headers of every request (DEBUG level only). [env var:
GALACTORY_LOG_HEADERS]
--log-body Log the body of every request (DEBUG level only). [env var:
GALACTORY_LOG_BODY]
--proxy-upstream PROXY_UPSTREAM
If set, then find, pull and cache results from the specified galaxy server
in addition to local. [env var: GALACTORY_PROXY_UPSTREAM]
-npns NO_PROXY_NAMESPACE, --no-proxy-namespace NO_PROXY_NAMESPACE
Requests for this namespace should never be proxied. Can be specified
multiple times. [env var: GALACTORY_NO_PROXY_NAMESPACE]
Args that start with '--' (eg. --listen-addr) can also be set in a config file
(/etc/galactory.d/*.conf or ~/.galactory/*.conf or specified via -c). Config file syntax allows:
key=value, flag=true, stuff=[a,b,c] (for details, see syntax at https://goo.gl/R74nmi). If an arg
is specified in more than one place, then commandline values override environment variables which
override config file values which override defaults.
Install
python3 -m pip install galactory
Container
Latest tagged release:
docker run --rm ghcr.io/briantist/galactory:latest --help
Latest commit on main
:
docker run --rm ghcr.io/briantist/galactory:main --help
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for galactory-0.4.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0b92cbcc5b2a447a6964271d3f53e044c611af74fc3ee4c4c8138efe4d9b49cd |
|
MD5 | b35322894bac19a1c9308eb040d54fb9 |
|
BLAKE2b-256 | 4923db06017cde51c35e361f9c8d4822c3bf611e02b5d032ca2354a656af6463 |