120 lines
4.5 KiB
ReStructuredText
120 lines
4.5 KiB
ReStructuredText
ARA: Ansible Run Analysis
|
|
=========================
|
|
.. image:: doc/source/_static/ara-with-icon.png
|
|
|
|
ARA is an open source project that was created by Ansible users for Ansible
|
|
users.
|
|
|
|
Its purpose is to provide a way to simply and easily understand what happens
|
|
throughout playbook runs at any scale.
|
|
|
|
ARA records Ansible playbook runs and makes the recorded data available and
|
|
intuitive for users and systems.
|
|
|
|
TL;DR
|
|
=====
|
|
|
|
ARA_ records Ansible_ Playbook runs seamlessly to make them easier to
|
|
visualize, understand and troubleshoot. It integrates with Ansible wherever you
|
|
run it.
|
|
|
|
ARA provides four things:
|
|
|
|
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`_
|
|
|
|
.. _ARA: https://github.com/openstack/ara
|
|
.. _Ansible: https://www.ansible.com/
|
|
.. _Ansible callback plugin: https://ara.readthedocs.io/en/latest/configuration.html#ansible
|
|
.. _ara_record: http://ara.readthedocs.io/en/latest/usage.html#using-the-ara-record-module
|
|
.. _ara_read: http://ara.readthedocs.io/en/latest/usage.html#using-the-ara-read-module
|
|
.. _CLI client: https://ara.readthedocs.io/en/latest/usage.html#querying-the-database-with-the-cli
|
|
.. _dynamic, database-driven web interface: https://ara.readthedocs.io/en/latest/faq.html#what-does-the-web-interface-look-like
|
|
.. _generated and served from static files: https://ara.readthedocs.io/en/latest/usage.html#generating-a-static-html-version-of-the-web-application
|
|
|
|
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`_
|
|
|
|
.. _YouTube: https://www.youtube.com/watch?v=k3i8VPCanGo
|
|
.. _OpenStack-Ansible: https://github.com/openstack/openstack-ansible
|
|
.. _the frequently asked questions: http://ara.readthedocs.io/en/latest/faq.html#interface-preview
|
|
|
|
Community and getting help
|
|
==========================
|
|
|
|
The ARA community hangs out on IRC on the freenode network.
|
|
|
|
Come chat with developers and users on the **#ara** channel !
|
|
|
|
Contributing, 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 !
|
|
|
|
* Submitted code reviews are available on **Gerrit**:
|
|
https://review.openstack.org/#/q/project:openstack/ara
|
|
* Bugs, issues and feature tracking are available on **StoryBoard**:
|
|
https://storyboard.openstack.org/#!/project/843
|
|
|
|
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.
|
|
|
|
.. _contributor documentation: https://ara.readthedocs.io/en/latest/contributing.html
|
|
.. _manifesto: https://ara.readthedocs.io/en/latest/manifesto.html
|
|
|
|
Documentation
|
|
=============
|
|
|
|
`Frequently asked questions`_ and documentation on how to install_, configure_,
|
|
use_ to ARA is available on `readthedocs.io`_.
|
|
|
|
.. _Frequently asked questions: https://ara.readthedocs.io/en/latest/faq.html
|
|
.. _install: https://ara.readthedocs.io/en/latest/installation.html
|
|
.. _configure: https://ara.readthedocs.io/en/latest/configuration.html
|
|
.. _use: https://ara.readthedocs.io/en/latest/usage.html
|
|
|
|
.. _readthedocs.io: https://ara.readthedocs.io/en/latest/
|
|
|
|
Contributors
|
|
============
|
|
|
|
See contributors on GitHub_.
|
|
|
|
.. _GitHub: https://github.com/openstack/ara/graphs/contributors
|
|
|
|
Copyright
|
|
=========
|
|
|
|
::
|
|
|
|
Copyright (c) 2017 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/>.
|