feat: add ARA

Author: ntk148v

Dockerfile

@@ -3,10 +3,13 @@ LABEL maintainer="Kien Nguyen-Tuan <[email protected]>"
 # Enable Mitogen to boostup performance
 ENV ANSIBLE_STRATEGY_PLUGINS=/usr/lib/python3.10/site-packages/ansible_mitogen/plugins/strategy
 ENV ANSIBLE_STRATEGY=mitogen_linear
+ENV ANSIBLE_CALLBACK_PLUGINS=/usr/lib/python3.10/site-packages/ara/plugins/callback
+ENV ANSIBLE_ACTION_PLUGINS=/usr/lib/python3.10/site-packages/ara/plugins/action
+ENV ANSIBLE_LOOKUP_PLUGINS=/usr/lib/python3.10/site-packages/ara/plugins/lookup
 COPY etc/ansible.example.cfg /etc/ansible/ansible.cfg
 COPY . /opt/ansitheus
 WORKDIR /opt/ansitheus
 RUN ansible-galaxy install -r requirements.yml
-# Mitogen needs sudo command to execute 
+# Mitogen needs sudo command to execute
 RUN apk add --no-cache sudo
 ENTRYPOINT ["/opt/ansitheus/tools/ansitheus"]

docs/images/ara_playbooks.png

@@ -0,0 +1,75 @@
+# Visualizing Ansitheus reports with ARA Records Ansible (ARA)
+
+## 1. About ara
+
+[ara](https://ara.recordsansible.org/) provides Ansible reporting by recording ``ansible`` and ``ansible-playbook`` commands regardless of how and where they run:
+
+- from most Linux distributions and even on Mac OS (as long as ``python >= 3.8`` is available)
+- from tools that run Ansible like ansible-(pull|test|runner|navigator), AWX & Automation Controller (Tower), Molecule and Semaphore
+- from a terminal, a script or by hand
+- from a laptop, desktop, server, virtual machine, container or execution environment
+- from CI/CD platforms such as Jenkins, Rundeck and Zuul
+- from git forges like GitHub, GitLab, Gitea & Forgejo
+
+The recorded results are available via an included CLI, a REST API as well as a self-hosted, local-first web reporting interface.
+
+<!-- https://github.com/ansible-community/ara/blob/master/doc/source/_static/demo.mp4 -->
+https://github.com/ansible-community/ara/assets/1291204/4fbdf5f7-509c-46ea-beb0-726b43e1b985
+
+## 2. Getting started
+
+Started from version v2.2.0, Ansitheus already bundles ara on its Docker image. Checkout the [quickstart](./quickstart.md) for detail.
+
+Firstly configure your ARA API server. Make sure it works properly. You can quickly deploy it using `docker-compose`:
+
+```yaml
+version: "3.8"
+
+services:
+  postgres:
+    image: postgres:latest
+    container_name: postgres
+    environment:
+      POSTGRES_USER: ara
+      POSTGRES_PASSWORD: ara_password
+      POSTGRES_DB: ara
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    restart: unless-stopped
+
+  ara:
+    image: recordsansible/ara-api:latest
+    container_name: ara
+    environment:
+      - ARA_ALLOWED_HOSTS=["*"]
+      - ARA_DATABASE_DRIVER=postgresql
+      - ARA_DATABASE_USER=ara
+      - ARA_DATABASE_PASSWORD=ara_password
+      - ARA_DATABASE_HOST=postgres
+      - ARA_DATABASE_NAME=ara
+    ports:
+      - "8000:8000"
+    depends_on:
+      - postgres
+    restart: unless-stopped
+
+volumes:
+  postgres_data:
+```
+
+Now you can use visualize Ansitheus report using ARA (**don't forget to update `ARA_API.*` variables**).
+
+```shell
+docker run --name ansitheus --rm --network host \
+    -e ARA_API_SERVER=http://localhost:8000 \
+    -e ARA_API_CLIENT=http \
+    -v /tmp/test/sub:/etc/ansitheus \
+    -v /tmp/facts_cache:/tmp/facts_cache \
+    kiennt26/ansitheus:v2.2.0 deploy --inventory /etc/ansitheus/inventory.ini
+```
+
+Result:
+
+![playbook](./images/ara_playbooks.png)
+
+![playbook_detail](./images/ara_playbooks_detail.png)

docs/images/ara_playbooks_detail.png

@@ -1 +1,2 @@
 ansible>=2.9.0
+ara>=1.7.2