Skip to main content

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.

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

Uploaded Source

Built Distribution

ara-0.14.6-py2.py3-none-any.whl (150.4 kB view details)

Uploaded Python 2Python 3

File details

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

File metadata

  • Download URL: ara-0.14.6.tar.gz
  • Upload date:
  • Size: 1.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for ara-0.14.6.tar.gz
Algorithm Hash digest
SHA256 3f612c177a28f6b0ce3a27d19a846151de7560c7799428521703841436ca0a05
MD5 bed8a3f2705f08843db6f6e81385b906
BLAKE2b-256 d615ffa5a010531f5f29dceadea3a97aafb15f33544a0fa71224e51c6cc30419

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for ara-0.14.6-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 13c545dd9e73f15bc267365738170313152464fb9a6506f5ad0af9d626f074ad
MD5 aca490c8ad4795d8f1f7bc09bdf8cfc5
BLAKE2b-256 c73daf736ecc01aca542af5fe391443120c2ae7685727f9cb948f2bde2920c10

See more details on using hashes here.

Supported by

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