RETIRED, this project has moved to https://github.com/ansible-community/ara
Go to file
Sorin Sbarnea 74557137f8 Eliminate use of ansible include
Removes obsoleted ansible syntax and uses current one "include_tasks"
is the recommended syntax for performing a dynamic (non-static) include.

Change-Id: If17df8c8fa909960743f4a1e6d3bed845209cce7
2019-01-02 09:26:49 +00:00
ara Eliminate use of ansible include 2019-01-02 09:26:49 +00:00
doc/source Remove the notion of ANSIBLE_LIBRARY from setup and docs 2018-11-28 11:17:13 -05:00
playbooks Simplify and streamline zuul v3 jobs 2017-11-07 16:22:16 -05:00
tests Fix testing warnings and makes future one treated as errors 2019-01-01 20:14:34 +00:00
zuul.d Fix testing warnings and makes future one treated as errors 2019-01-01 20:14:34 +00:00
.coveragerc Output the coverage report to cover/ 2016-06-14 14:32:16 -04:00
.gitignore Add pytest_cache to .gitignore 2018-02-05 17:21:20 -05:00
.gitreview add .gitreview file for review.openstack.org 2016-06-09 05:13:42 +00:00
LICENSE Re-license ARA from ASLv2 to GPLv3 2017-07-24 19:30:34 +00:00
README.rst Merge "Update versions of Ansible for integration jobs, Ansible 2.4.x is EOL" 2018-11-14 03:33:35 +00:00
bindep.txt Simplify and streamline zuul v3 jobs 2017-11-07 16:22:16 -05:00
requirements.txt Update versions of Ansible for integration jobs, Ansible 2.4.x is EOL 2018-11-13 21:06:20 -05:00
run_tests.sh Remove the notion of ANSIBLE_LIBRARY from setup and docs 2018-11-28 11:17:13 -05:00
setup.cfg Change openstack-dev to openstack-discuss 2018-12-07 20:27:50 +08:00
setup.py Rebrand Ansible Run Analysis to ARA Records Ansible 2018-04-20 15:01:04 +00:00
test-requirements.txt Freeze cmd2 library on python2 2018-05-30 17:46:53 +01:00
tox.ini Fix testing warnings and makes future one treated as errors 2019-01-01 20:14:34 +00:00

README.rst

ARA Records Ansible

image

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.

image

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

You can chat with the ARA community on Slack and IRC. The two are transparently bridged with teamchat which broadcasts messages from one platform to the other.

In addition, you can also find ARA on Twitter: @ARecordsAnsible

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.5.9

py27

Ansible 2.6.5

py27

Ansible 2.7.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.

Copyright

Copyright (c) 2018 Red Hat, Inc.

ARA is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

ARA is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with ARA.  If not, see <http://www.gnu.org/licenses/>.