Skip to main content

ARA Records Ansible

Project description

ARA Records Ansible

ARA Records Ansible playbooks and makes them easier to understand and troubleshoot.

doc/source/_static/ara-with-icon.png

ARA saves playbook results to a local or remote database by using an Ansible callback plugin and provides an API to integrate this data in tools and interfaces.

This project provides the ARA API as well as the Ansible components.

For the web client interface, see ara-web.

Quickstart

Here’s how you can get started from scratch with sane defaults:

# Create a python3 virtual environment and activate it so we don't conflict
# with system or distribution packages
python3 -m venv ~/.ara/virtualenv
source ~/.ara/virtualenv/bin/activate

# Install Ansible, ARA and it's API server dependencies
pip install ansible ara[server]

# Tell Ansible to use the ARA callback plugin
export ANSIBLE_CALLBACK_PLUGINS="$(python -m ara.setup.callback_plugins)"

# Run your playbook as usual
ansible-playbook playbook.yml

If nothing went wrong, your playbook data should have been saved in a local database at ~/.ara/server/ansible.sqlite.

You can browse this data through the API by executing ara-manage runserver and pointing your browser at http://127.0.0.1:8000/.

That’s it !

Live demos

You can find live demos deployed by the built-in ara_api and ara_web Ansible roles at https://api.demo.recordsansible.org and https://web.demo.recordsansible.org.

Documentation

Documentation for installing, configuring, running and using ARA is available on readthedocs.io.

Community and getting help

Contributors

See contributors on GitHub.

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

ara-1.0.0.0rc1.tar.gz (559.1 kB view details)

Uploaded Source

Built Distribution

ara-1.0.0.0rc1-py2.py3-none-any.whl (69.7 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file ara-1.0.0.0rc1.tar.gz.

File metadata

  • Download URL: ara-1.0.0.0rc1.tar.gz
  • Upload date:
  • Size: 559.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.5.2

File hashes

Hashes for ara-1.0.0.0rc1.tar.gz
Algorithm Hash digest
SHA256 bd774ca17ad05ed5d08dd7317bf1e189584e77395adb9294ba3fa498d525f8a2
MD5 e93acdb81395bafc334b959e27d06fd4
BLAKE2b-256 643df32ae7a34da4320b47d06bc47dbd9ecefcc051e716420beabd8a0239dcb2

See more details on using hashes here.

File details

Details for the file ara-1.0.0.0rc1-py2.py3-none-any.whl.

File metadata

  • Download URL: ara-1.0.0.0rc1-py2.py3-none-any.whl
  • Upload date:
  • Size: 69.7 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.5.2

File hashes

Hashes for ara-1.0.0.0rc1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 99fd5a4721c0d51b8ce9ab11ba7a2472805499ac91062b3c1c3e41d9a7a49ca6
MD5 c0b1a72771077ac07000a5acb4df6159
BLAKE2b-256 a145e01bfbbcad1c77d99d5b1aad532cd409bcecb58f05b4cf50d806e4e5ab91

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page