Skip to main content

ARA Records Ansible

Project description

ARA Records Ansible

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

ARA Records Ansible playbook runs and makes the recorded data available and intuitive for users and systems.

ARA doesn’t run your playbooks for you: it integrates with Ansible as a callback plugin wherever it is.

Whether you are running Ansible from your personal laptop or a server, all you need to do is to install ARA, configure Ansible to use ARA and you’re good to go.

doc/source/_static/reports.png

Quickstart

# Install ARA
pip install ara

# Load environment variables that inform Ansible to use ARA regardless
# of its location or python version
source <(python -m ara.setup.env)

# Run your Ansible playbook or commands
# ansible-playbook myplaybook.yml

# Start the ARA standalone webserver
ara-manage runserver
# Browse http://127.0.0.1:9191

Refer to the documentation for more information.

ARA components

ARA has four main components:

  1. An Ansible callback plugin to record playbook runs into a local or remote database

  2. The ara_record and ara_read pair of Ansible modules to record and read persistent data with ARA

  3. A CLI client to query the database

  4. A dynamic, database-driven web interface that can also be generated and served from static files

What does the web interface look like ?

A video preview and explanation of the web interface is available on YouTube, featuring playbook runs from the OpenStack-Ansible project.

Otherwise, screenshots highlighting some of ARA’s features are available in the frequently asked questions

Community and getting help

The ARA community hangs out on IRC and Slack. The two chats are bridged with slack-irc which allows everyone to talk to each other.

IRC

Slack

Contributing, testing, issues and bugs

Contributions to ARA are definitely welcome and much appreciated !

ARA does not use GitHub for issues or pull requests.

ARA uses the OpenStack infrastructure for code hosting and review as well as project and bug/issue tracking.

The contributor documentation will get you started quickly if you need help contributing !

Each commit to ARA is reviewed and also rigorously tested to prevent regressions. Here’s our current testing coverage:

Fedora

CentOS

OpenSUSE

Debian

Ubuntu

Ansible 2.4.5.0

py27

Ansible 2.5.5

py27

Ansible 2.6.0

py35

py27

py35

Ansible “devel”

py35

py35

You might also be interested in reading the project manifesto in order to have a good understanding of the project’s core values and philosophy.

Documentation

Frequently asked questions and documentation on how to install, configure, use to ARA is available on readthedocs.io.

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-0.16.1.tar.gz (1.2 MB view details)

Uploaded Source

Built Distribution

ara-0.16.1-py2.py3-none-any.whl (152.1 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file ara-0.16.1.tar.gz.

File metadata

  • Download URL: ara-0.16.1.tar.gz
  • Upload date:
  • Size: 1.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.25.0 CPython/2.7.12

File hashes

Hashes for ara-0.16.1.tar.gz
Algorithm Hash digest
SHA256 6fd16e3aaddaf15fdfc804c5a57af9ee08716a581a6650a6b97886f63b0ddae6
MD5 6269a4675912e45ab8f647c26bb1b7b2
BLAKE2b-256 5d8133921a57d64daeedaec3d5d2028c0d04592fdb0ac0e8a77d2d8b4bac793e

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ara-0.16.1-py2.py3-none-any.whl
  • Upload date:
  • Size: 152.1 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.25.0 CPython/2.7.12

File hashes

Hashes for ara-0.16.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 e744fabd403b0b8d25896d8942fd45a33190a85bd5cd947294d92a3403ae3ce0
MD5 0f7f5c9e2be00d944f02303cc120d0be
BLAKE2b-256 68cddee19950ae6c5cbd27a065156536a1dc8a88faa481122701e4f13ceeabf4

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