Skip to main content
Help us improve Python packaging – donate today!

ARA - Ansible run analysis

Project Description

ARA: Ansible Run Analysis

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
# Make Ansible use the ARA callback plugin regardless of python version
export ANSIBLE_CALLBACK_PLUGINS="$(python -c 'import os,ara; print(os.path.dirname(ara.__file__))')/plugins/callbacks"
# Run your playbook
# 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, Slack and Discord.

All three chats are seamlessly linked to each other so you can use your preferred client to come chat with us !

IRC

Slack

Discord

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.2.3.0       X  
Ansible 2.3.2.0   X      
Ansible “latest” X   X   X
Ansible “devel” X       X

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.

Release history Release notifications

This version
History Node

0.14.6

History Node

0.14.6.0rc1

History Node

0.14.5

History Node

0.14.5.0rc2

History Node

0.14.5.0rc1

History Node

0.14.4

History Node

0.14.4.0rc1

History Node

0.14.3

History Node

0.14.3.0rc1

History Node

0.14.2

History Node

0.14.1

History Node

0.14.1.0rc1

History Node

0.14.0

History Node

0.13.3

History Node

0.13.2

History Node

0.13.1

History Node

0.13.0

History Node

0.12.5

History Node

0.12.4

History Node

0.12.3

History Node

0.12.2

History Node

0.12.1

History Node

0.12.0

History Node

0.11.0

History Node

0.10.5

History Node

0.10.4

History Node

0.10.3

History Node

0.10.2

History Node

0.10.1

History Node

0.10.0

History Node

0.9.3

History Node

0.9.2

History Node

0.9.1

History Node

0.9.0

History Node

0.8.1

History Node

0.8.0

History Node

0.7.1

History Node

0.7.0

History Node

0.6.0

History Node

0.5.2

History Node

0.5.1

History Node

0.5.0

History Node

0.4.0

History Node

0.3.1

History Node

0.3.0

History Node

0.2.0

History Node

0.1.0

History Node

0.0.1.dev1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
ara-0.14.6-py2.py3-none-any.whl (150.4 kB) Copy SHA256 hash SHA256 Wheel py2.py3 Feb 13, 2018
ara-0.14.6.tar.gz (1.2 MB) Copy SHA256 hash SHA256 Source None Feb 13, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page