ARA Records Ansible Playbook Reporting

AWS Developer Tools

record every Ansible playbook run and browse the results in a web reporting UI and REST API

Base
Hardened build
minimal ports, security patches applied at build time
Access
Unique credentials
generated on first boot, readable only by root
Verified
Boots working
services pass a health gate before release
Support
24/7, 365 days
by email and live chat, 24 hour response SLA

Overview

ARA Records Ansible is a self-hosted reporting tool for Ansible. A lightweight callback plugin records the plays, tasks, hosts and results of every playbook run, and a web interface backed by a REST API makes them searchable and easy to troubleshoot. Point your Ansible at the recorder, run your playbooks exactly as you do today, and a durable, queryable record of what ran, where, how long it took and what changed builds up automatically.

Why the cloudimg image

A stock ARA server allows unauthenticated reading AND writing of your whole automation history. The cloudimg image requires authentication on the entire interface and the entire API, ships zero user accounts, and generates a fresh application secret key and a unique administrator password on the first boot of every instance, written to a root-only file. Ansible and the recording callback are installed on the appliance itself, so it records runs out of the box, and the application, its virtual environment and the recording database sit on a dedicated, independently resizable data volume. Paired with a step by step deploy guide and 24/7 cloudimg support.

Common uses

  • Troubleshoot failed automation by jumping straight to the failed task, host and result
  • Keep a durable, searchable audit trail of every change your automation made
  • Give teams visibility of automated deployments without access to the pipeline

Key features

  • Launch a complete Ansible playbook reporting platform in minutes - ARA, nginx reverse proxy, recording callback, and Ansible are preinstalled and preconfigured. No manual Django, application server, or database setup required. The web UI and REST API are answering immediately, recording runs out of the box from the appliance itself or from any remote control node you connect.
  • Secure by default where a stock ARA install is not - a standard server allows unauthenticated read and write access to your entire automation history. This image enforces authentication on the full interface and API, ships zero user accounts, and generates a unique application secret key and random administrator password on every instance at first boot. No two instances ever share a credential.
  • Dedicated resizable EBS data volume keeps your recording database independent of the root disk, so you can grow storage as playbook history accumulates. The application is bound to loopback behind nginx, an unauthenticated health endpoint is ready for ALB target group probes, and 24/7 cloudimg support covers deployment, TLS, sizing, and upgrades.

See it running

Real screenshots taken while testing this image against its deployment guide.

ARA Records Ansible Playbook Reporting screenshot 1 ARA Records Ansible Playbook Reporting screenshot 2 ARA Records Ansible Playbook Reporting screenshot 3 ARA Records Ansible Playbook Reporting screenshot 4

Description

This is a repackaged open source software product wherein additional charges apply for cloudimg support services.

## See What Your Ansible Actually Did

ARA Records Ansible is a widely adopted open source reporting tool for Ansible. A lightweight callback plugin records the plays, tasks, hosts, and results of every playbook run, while a clean web interface backed by a REST API makes them easy to browse, search, and troubleshoot. Point your Ansible at the recorder, run your playbooks exactly as you do today, and a durable, queryable record of what ran, where, how long it took, and what changed builds up automatically.

This image delivers ARA fully installed and reverse-proxied behind nginx, so a complete Ansible reporting platform is answering within minutes of launch with no manual Django, application server, web server, or database configuration.

## Why This Image Instead of Self-Deploy

Standing up ARA by hand means creating a virtual environment, pinning the server extras, writing an application server unit, configuring a reverse proxy, initialising a database, generating an application secret key, and then closing the security hole that a default install leaves wide open. This image removes all of it:

  • Authentication required for both reading and writing on the entire reporting interface and the entire REST API
  • No administrator account and no shared password anywhere in the image
  • A unique application secret key and a unique administrator password generated on every instance at first boot
  • Recording database and application on a dedicated, independently resizable data volume
  • Ansible and the recording callback installed on the appliance itself, so it records out of the box
  • An unauthenticated health endpoint ready to use as a load balancer target group probe
  • 24/7 cloudimg support for deployment, upgrades, TLS termination, and control node configuration

## Secure by Default

This matters more than it looks. A stock ARA server defaults to unauthenticated read AND unauthenticated write, so anyone who can reach port 80 can read every recorded playbook, every host name, and every task result - and can also write records into your history. This image turns both login requirements on, so the reporting interface and the API are gated behind HTTP authentication from the very first request.

No credential ships in the image at all. The database is deleted before capture, so the image contains zero user accounts. On first boot a one-shot service generates a fresh application secret key, initialises an empty database, creates a single administrator with a random password unique to that instance, and writes it to a file readable only by root. You retrieve it over SSH, sign in from your browser, and start recording. Two instances launched from this image never share a secret.

## How It Is Assembled

The application runs under an unprivileged service account bound to the loopback interface only, with nginx published on port 80 in front of it. The recording database is self-contained, so there is no separate database server to run, patch, or pay for on a single-node deployment, and it lives with the application on its own EBS volume that you can grow as your playbook history does. Only the reverse proxy is reachable from outside the instance.

## Use Cases

  • Troubleshoot failed automation: Jump straight to the failed task, on the failed host, in the failed run, with its full result and duration, instead of scrolling back through terminal output that nobody kept.
  • Automation audit trail: Keep a durable, searchable record of every change your automation made across environments, in your own account, for change review and compliance evidence.
  • Pipeline visibility: Have every automated deployment report itself so anyone can see what the last run did without having access to the pipeline that ran it.

## Evaluation and Getting Started

Because this image bills hourly, you can evaluate it on a small instance at minimal commitment - launch, explore the web UI, record a few test playbooks, and terminate when done. No long-term contract is required.

Launch the image, read your administrator password from the root-only credentials file, and sign in. Then export a handful of environment variables on any control node to start sending it your own playbook runs. The paired cloudimg user guide covers sign-in, connecting remote control nodes, user management, TLS, and backup: https://www.cloudimg.co.uk/guides/ara-aws/

## Licensing

This image ships ARA Records Ansible unmodified from the upstream release, distributed under the GNU General Public License version 3. cloudimg is not affiliated with, endorsed by, or sponsored by the ARA project or Red Hat. All product and company names are trademarks or registered trademarks of their respective holders, and their use does not imply any affiliation with or endorsement by them.

Related technologies

ansible reportingplaybook auditansible callback pluginautomation audit trailansible web uiara records ansibledevops reportingci cd visibilityconfiguration managementinfrastructure automationansible troubleshootingself hosted ansible