ecb204230f
ARA was originally licensed as Apache 2.0 software to align with the license used by the larger community of OpenStack software. However, ARA is fairly coupled with Ansible, which is GPLv3. By maintaining two licenses simultaneously, we may unknowingly infringe on the incompatibility of the licenses by importing or linking code to and from Ansible software. In order to avoid the headaches involved in maintaining two licenses side by side, remove the ambiguity as to what is the effective license, we are relicensing ARA to be fully GPLv3. Since ARA is not an official OpenStack project, it does not have an impact on it's status within the OpenStack community [1] and will remain as a hosted project. We are doing this license change now rather than later as doing this change later becomes increasingly complicated as the project gains more code contributors. [1]: http://lists.openstack.org/pipermail/legal-discuss/2017-July/000474.html Change-Id: I2ec1e0a1d1b38fc74dcb6af2b4f81226d1faa0df |
||
|---|---|---|
| ara | ||
| doc/source | ||
| .coveragerc | ||
| .gitignore | ||
| .gitreview | ||
| LICENSE | ||
| README.rst | ||
| bindep.txt | ||
| requirements.txt | ||
| run_tests.sh | ||
| setup.cfg | ||
| setup.py | ||
| test-requirements.txt | ||
| tox.ini | ||
README.rst
ARA: Ansible Run Analysis
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:
- An Ansible callback plugin to record playbook runs into a local or remote database
- The ara_record and ara_read pair of Ansible modules to record and read persistent data with ARA
- A CLI client to query the database
- 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 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.
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) 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/>.