ARA records Ansible Playbook runs and provides intuitive interfaces to browse them
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Zuul d9df520e02 Merge "callback: improve consistency of stored task results" 1 month ago
.github/ISSUE_TEMPLATE Add GitHub issue templates for bugs and enhancements 9 months ago
.zuul.d zuul: Use no_log when setting up authentication 2 months ago
ara Merge "callback: improve consistency of stored task results" 1 month ago
doc docs: Update format for providing lists to plugin configuration 2 months ago
playbooks Re-structure integration tests 9 months ago
roles ara_api role: Default gunicorn worker count based on CPU cores 2 months ago
tests zuul: allow retries when lauching database containers 2 months ago
.black.toml Rename pyproject.toml to .black.toml to address pep517 11 months ago
.editorconfig :boom: first commit 2 years ago
.gitignore Feature to ignore Ansible files based on patterns. 2 months ago
.gitreview Switch default branch from feature/1.0 to master 9 months ago
LICENSE :boom: first commit 2 years ago
README.rst Remove f-strings to remove requirement on py36 4 months ago
manage.py Add missing license headers 11 months ago
requirements.txt Add a comment in requirements.txt about location of server deps 10 months ago
setup.cfg api: Pin django to <3.0 3 months ago
setup.py Bootstrap the repository with the basic machinery (#1) 2 years ago
test-requirements.txt docs: isolate docs requirements and add API server dependencies 4 months ago
tox.ini docs: isolate docs requirements and add API server dependencies 4 months ago

README.rst

ARA Records Ansible

ARA Records Ansible playbooks and makes them easier to understand and troubleshoot.

image

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:

If 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

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