theknightcoder/ara

ARA镜像中文文档

镜像概述

ARA（Ansible Run Analysis）是一款专注于Ansible playbook运行记录的工具，本Docker镜像封装了ARA及其依赖环境，支持将playbook运行数据存储到SQLite数据库（默认），并通过Web界面直观呈现运行报告，帮助用户高效追踪自动化任务的执行情况。

核心功能

1. 运行记录：完整记录Ansible playbook的执行过程，包括主机列表、任务状态、执行时长等关键信息；
2. 数据存储：默认使用SQLite数据库（文件路径：files/db/ara.sqlite），支持通过环境变量切换为集中式数据库（如PostgreSQL、MySQL）；
3. Web展示：提供可视化Web界面，展示playbook运行摘要、主机执行详情及结果统计；
4. 集成性：与Ansible容器无缝集成，支持快速启动和使用，降低部署门槛。

使用场景

• 自动化审计：回溯Ansible playbook的执行历史，用于合规检查或问题定位；
• 团队协作：共享playbook运行结果，方便团队成员同步任务状态；
• 效率分析：分析自动化任务的执行效率，优化playbook性能；
• 网络自动化：记录网络设备配置任务的运行情况，支持Cisco IOS等设备的自动化管理。

配置说明

• 数据库配置：修改ARA_DATABASE环境变量可切换数据库类型，例如：ARA_DATABASE=postgresql://user:pass@host:port/db；
• 端口映射：ARA Web界面默认映射端口为8000，可在docker-compose.yml中调整ports字段；
• 数据持久化：通过卷映射将主机目录与容器内/ansible目录关联，确保运行数据不丢失。

Docker部署示例

首次启动ARA和Ansible容器

bash
cd /vagrant && docker-compose run --service-ports --name ara -d ara && docker-compose run --service-ports --rm ansible

后续启动

bash
cd /vagrant && docker start ara && docker-compose run --service-ports --rm ansible

仅启动Ansible容器

bash
cd /vagrant && docker-compose run --service-ports --rm ansible

停止容器

bash
exit  # 退出Ansible容器（自动删除）
docker stop ara  # 停止ARA容器