ARA Records Ansible
Project description
ARA Records Ansible
ARA Records Ansible playbooks and makes them easier to understand and troubleshoot.
ARA saves playbook results to a local or remote database by using an Ansible callback plugin and provides an API to integrate this data in tools and interfaces.
This project provides ARA’s Ansible plugins, the REST API server as well as simple built-in web interfaces to browse the recorded data.
A stateless javascript client interface is provided by a different project, ara-web.
Quickstart
Here’s how you can get started from scratch with sane defaults with python>=3.5:
# Install ARA and Ansible for the current user
python3 -m pip install --user ansible "ara[server]"
# Tell Ansible to use the ARA callback plugin
export ANSIBLE_CALLBACK_PLUGINS="$(python3 -m ara.setup.callback_plugins)"
# Run your playbook
ansible-playbook playbook.ymlIf nothing went wrong, your playbook data should have been saved in a local database at ~/.ara/server/ansible.sqlite.
You can take a look at the recorded data by running ara-manage runserver and pointing your browser at http://127.0.0.1:8000/.
That’s it !
Live demos
You can find live demos deployed by the built-in ara_api and ara_web Ansible roles at https://api.demo.recordsansible.org and https://web.demo.recordsansible.org.
Documentation
Documentation for installing, configuring, running and using ARA is available on readthedocs.io.
Community and getting help
Bugs, issues and enhancements: https://github.com/ansible-community/ara/issues
IRC: #ara on Freenode
Website and blog: https://ara.recordsansible.org
Twitter: https://twitter.com/arecordsansible
Contributors
See contributors on GitHub.
Copyright
Copyright (c) 2019 Red Hat, Inc. ARA Records Ansible 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 Records Ansible 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 Records Ansible. 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-1.4.0.tar.gz.
File metadata
- Download URL: ara-1.4.0.tar.gz
- Upload date:
- Size: 975.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.15.0 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.1.3 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.5.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 972abf28a1d0914f9d2f91a687e0c14b364e6cbb52099c8cc3c412edb81b43b4 |
|
| MD5 | 5042e103193eae44e6b9087650856f04 |
|
| BLAKE2b-256 | 1005c7682cfd389e695c258bb415ae59469bbb3bc9564e1145c05d23af0f3ec1 |
File details
Details for the file ara-1.4.0-py2.py3-none-any.whl.
File metadata
- Download URL: ara-1.4.0-py2.py3-none-any.whl
- Upload date:
- Size: 387.5 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.15.0 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.1.3 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.5.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | e6e89b87debf0eeab93ef8c6b24936110bc5894661206e35c005341a0b97168e |
|
| MD5 | 12bbedfdf33ff75639ced723e2b6b1e9 |
|
| BLAKE2b-256 | 364639374807ec482d1d1697448b0273556e3545a4670e1f4a90d980dce0aeaa |
