ansibleguy/ansibleforms

AnsibleForms Docker镜像文档

镜像概述和主要用途

AnsibleForms是一款轻量级Web图形用户界面（GUI）工具，旨在简化Ansible和AWX（Ansible Tower）的管理流程。该工具通过直观的可视化界面，帮助用户无需依赖命令行即可完成Ansible任务、剧本（Playbook）和工作流的创建、执行、监控与管理，降低Ansible使用门槛，提升团队协作效率。

主要用途包括：

• 管理Ansible剧本和任务
• 执行、监控Ansible任务运行状态
• 与AWX平台集成，统一管理Ansible资源
• 简化Ansible初学者的操作流程

核心功能和特性

核心功能

• 直观的Web界面：基于浏览器的图形化操作界面，无需命令行基础即可使用
• 剧本管理：支持Ansible剧本的上传、编辑、版本控制和分类管理
• 任务执行与监控：可视化执行Ansible任务，实时展示任务进度、日志和结果
• AWX集成：无缝对接AWX平台，支持从AWX导入资源、同步工作流
• 权限控制：基础用户权限管理，支持多用户协作与资源隔离

特性

• 轻量级架构：基于Python和Web框架构建，资源占用低，部署简单
• 跨平台兼容：支持主流操作系统（Linux、Windows、macOS）的Docker环境
• 配置灵活：通过环境变量快速配置与Ansible/AWX的连接参数
• 实时日志：任务执行过程中实时输出日志，便于问题排查
• 无数据库依赖：基础功能无需外部数据库，简化部署流程

使用场景和适用范围

适用用户

• Ansible初学者：降低命令行操作门槛，通过图形界面快速上手
• DevOps团队：简化Ansible任务协作流程，提升团队管理效率
• AWX用户：扩展AWX的可视化管理能力，整合任务与工作流
• 小型企业/团队：无需复杂部署即可实现Ansible资源的集中管理

典型场景

• 快速创建和执行临时Ansible任务
• 管理团队共享的Ansible剧本库
• 监控Ansible任务在生产环境中的运行状态
• 与AWX联动实现复杂工作流的可视化编排

使用方法和配置说明

前提条件

• 已安装Docker Engine（20.10+）或Docker Desktop
• 已部署Ansible控制节点或AWX平台（可选，用于功能完整使用）
• 网络环境允许容器暴露Web端口（默认80端口）

Docker部署示例

1. 基础Docker Run命令

bash
docker run -d \
  --name ansibleforms \
  -p 8080:80 \
  -e ANSIBLE_URL="http://your-ansible-control-node:5000" \
  -e AWX_URL="http://your-awx-server:80" \
  -e LOG_LEVEL="info" \
  ansibleforms/ansibleforms:latest

2. Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  ansibleforms:
    image: ansibleforms/ansibleforms:latest
    container_name: ansibleforms
    restart: always
    ports:
      - "8080:80"  # 宿主机端口:容器内端口
    environment:
      - ANSIBLE_URL=http://your-ansible-control-node:5000  # Ansible控制节点API地址
      - AWX_URL=http://your-awx-server:80  # AWX服务器地址（可选）
      - PORT=80  # 容器内Web服务端口（默认80）
      - LOG_LEVEL=info  # 日志级别（debug/info/warn/error，默认info）
      - TZ=Asia/Shanghai  # 时区设置
    volumes:
      - ./ansibleforms-data:/app/data  # 持久化存储配置和剧本（可选）

启动服务：

bash
docker-compose up -d

配置参数说明

基本使用步骤

1. 启动容器：通过上述docker run或docker-compose命令启动AnsibleForms容器
2. 访问界面：在浏览器中访问 http://<宿主机IP>:8080（端口根据部署时映射的宿主机端口调整）
3. 配置连接：首次登录后，在"设置"页面配置Ansible控制节点（或AWX）的连接参数（如API令牌、认证方式）
4. 管理资源：从界面左侧菜单进入"剧本管理"上传Ansible剧本，或从"任务"页面创建新任务
5. 执行任务：选择剧本或任务，点击"执行"按钮，在"任务监控"页面查看实时进度和结果

注意事项

• 确保Ansible控制节点/AWX服务器与AnsibleForms容器网络互通
• 持久化存储（./ansibleforms-data卷）建议用于生产环境，避免容器重启后丢失配置和剧本
• 启用用户认证（AUTH_ENABLED=true）时，建议修改默认管理员密码（ADMIN_PASSWORD）
• 高并发场景下，可通过调整容器资源限制（如--memory、--cpus）优化性能