Rundeck Resources

Gitlab-CI Pipeline CodeCov.io Documentation Status Pypi Package Version Python Versions Supported BSD License

Python tool to query resources from different sources and export them into a data structure that Rundeck can consume.

Installation

pip install rundeck-resources

Usage

$ rundeck-resources -h
usage: rundeck-resources [-h] [-v] [-l LOGGER] [--no-cache] [-V] config

Generates rundeck resources file from different API sources.

positional arguments:
  config                Configuration file.

optional arguments:
  -h, --help            show this help message and exit
  -v, --verbose         Verbosity level to use.
  -l LOGGER, --logger LOGGER
                        The logger YAML configuration file.
  --no-cache            Do not use cache.
  -V, --version         Prints version.

The rundeck-resources requires an INI configuration file. You can see the example configuration in the example.ini.

Docker

There is a docker image tagged with the version of the released package.

ENV OPTIONAL DESCRIPTION
ARGS True The command line arguments.
CONFIG False The path to the configuration file.
Usage:
$ docker run -it -v ~/config/:/config \
  -v ~/export/:/export \
  -e ARGS="-vvv" -e CONFIG="/config/config.ini" \
  elazkani/rundeck-resources
Assumptions:
  • ~/config/ holds the config.ini configuration file.
  • The configuration is set to export to the /export/ path.
  • /export will hold the resources exported file inside the container.
  • ~/export/ exists on the host.

Importers

rundeck-resources currently offer the following importers:
  • Chef: ChefImporter

Exporters

rundeck-resources currently offers the following exporters:
  • YAML: YAMLExporter

Indices and tables