ARA Records Ansible
Project description
ARA Records Ansible
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.
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:
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
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
Server: irc.freenode.net
Channel: #ara
Slack
Join with the Slack invitation
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 !
Submitted code reviews are available on Gerrit: https://review.opendev.org/#/q/project:%255Erecordsansible/.*
Bugs, issues and feature tracking are available on GitHub: https://github.com/ansible-community/ara/issues
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.6.19 |
py27 |
||||
Ansible 2.7.13 |
py27 |
||||
Ansible 2.8.4 |
py37 |
py27 |
py36 |
||
Ansible “devel” |
py37 |
py36 |
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/>.
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
Built Distribution
File details
Details for the file ara-0.16.6.0rc1.tar.gz.
File metadata
- Download URL: ara-0.16.6.0rc1.tar.gz
- Upload date:
- Size: 1.2 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.15.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.6.0 requests-toolbelt/0.9.1 tqdm/4.38.0 CPython/3.5.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | af9af21c4a90e8bf57d8250ff9c9a60a9f848662e0bc5d14f6675e772109f321 |
|
| MD5 | 1c1cc38fce88f3a95964bf56601d6c3f |
|
| BLAKE2b-256 | 4fbe4f6dcedfa2eed831438736815ea813654ea71da2208e18df0687ec45e70c |
File details
Details for the file ara-0.16.6.0rc1-py2.py3-none-any.whl.
File metadata
- Download URL: ara-0.16.6.0rc1-py2.py3-none-any.whl
- Upload date:
- Size: 164.6 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.15.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.6.0 requests-toolbelt/0.9.1 tqdm/4.38.0 CPython/3.5.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 70359a6de7f4b4c8398931c6a5006381b3b18ac83d989708e928bc465e1e3bcd |
|
| MD5 | 0037e9a1586917184a3514198d999c12 |
|
| BLAKE2b-256 | 3801c796afd5e921a919626d9517bc678d4e73446033b5e1450cbb1a89d3b4cb |
