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.
Matt Bond 8d6b063dfc add django-healthcheck and /healthcheck/ endpoint 1 week ago
.github/ISSUE_TEMPLATE Add GitHub issue templates for bugs and enhancements 4 months ago
.zuul.d Add distributed_sqlite db backend and WSGI app 3 months ago
ara add django-healthcheck and /healthcheck/ endpoint 1 week ago
doc/source Docs: Bump version for Django documentation links 4 weeks ago
playbooks Re-structure integration tests 3 months ago
roles Add missing docs and ara_api role support for TIME_ZONE 4 weeks ago
tests Change default for ARA_DISTRIBUTED_SQLITE_PREFIX to /ara-report 2 months ago
.black.toml Rename pyproject.toml to .black.toml to address pep517 5 months ago
.editorconfig :boom: first commit 1 year ago
.gitignore Also ignore .venv directories. 5 months ago
.gitreview Switch default branch from feature/1.0 to master 4 months ago
LICENSE :boom: first commit 1 year ago
README.rst Switch default branch from feature/1.0 to master 4 months ago
manage.py Add missing license headers 5 months ago
requirements.txt Add a comment in requirements.txt about location of server deps 4 months ago
setup.cfg add django-healthcheck and /healthcheck/ endpoint 1 week ago
setup.py Bootstrap the repository with the basic machinery (#1) 1 year ago
test-requirements.txt Updated black dependency. 5 months ago
tox.ini Re-structure integration tests 3 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 the ARA API as well as the Ansible components.

For the web client interface, see ara-web.

Quickstart

Here's how you can get started from scratch with sane defaults:

If nothing went wrong, your playbook data should have been saved in a local database at ~/.ara/server/ansible.sqlite.

You can browse this data through the API by executing 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/>.