qonnectit/awx-ee-customized

Custom AWX EE 镜像文档

镜像概述

Custom AWX EE 是基于官方 AWX Execution Environment 构建的自定义执行环境镜像，专为 Ansible 自动化平台设计，用于承载 Ansible 任务的执行。该镜像允许用户根据实际需求定制工具链、预装依赖包及配置环境，解决官方镜像在特定场景下的工具或依赖限制，提升自动化任务的灵活性和适应性。

核心功能与特性

1. 定制化工具链集成

• 支持集成特定版本的系统工具（如 kubectl、aws-cli、terraform 等）及 Ansible 插件（如 ansible-navigator、ansible-lint），满足多样化自动化任务需求。
• 可通过构建参数或配置文件指定工具版本，确保工具链一致性。

2. 依赖管理能力

• 支持预装 Python 依赖包（通过 requirements.txt）、系统依赖（通过 bindep.txt）及 Ansible 集合（通过 collections/requirements.yml），避免任务执行时动态安装依赖导致的延迟或网络依赖。

3. 环境隔离与一致性

• 基于容器化技术，确保自动化任务在隔离环境中执行，避免主机环境干扰。
• 统一的执行环境配置，消除因环境差异导致的任务执行结果不一致问题。

4. 兼容性与扩展性

• 兼容 AWX/Tower 平台的任务调度机制，可直接作为执行环境关联至 AWX 模板。
• 支持通过环境变量、卷挂载等方式动态注入配置，无需重新构建镜像即可调整执行参数。

使用场景与适用范围

1. 企业内部定制化自动化

• 适用于企业内部有特定工具链需求的场景（如集成内部私有工具、合规审计工具）。
• 解决官方镜像中缺失行业特定工具（如***领域的 yq、运维领域的 helm）的问题。

2. 多环境适配需求

• 支持为开发、测试、生产等不同环境构建差异化镜像，通过定制依赖和配置适配环境特性（如代理设置、证书配置）。

3. 复杂任务执行优化

• 针对包含多工具协同的复杂自动化任务（如 "Ansible 剧本+Terraform 资源编排+AWS CLI 资源验证"），预装全套工具链以提升执行效率。

使用方法与配置说明

镜像拉取与运行

1. 拉取镜像

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/custom-awx-ee:latest

注：[镜像仓库地址] 需替换为实际镜像存放的仓库地址（如私有 Registry、Docker Hub 等）。

2. 基本运行命令

bash
docker run -d \
  --name custom-awx-ee-instance \
  -e ANSIBLE_CONFIG=/etc/ansible/ansible.cfg \  # 指定Ansible配置文件路径
  -v /path/to/local/playbooks:/ansible/playbooks \  # 挂载本地Ansible剧本
  -v /path/to/local/config:/etc/ansible \  # 挂载自定义Ansible配置
  [镜像仓库地址]/custom-awx-ee:latest

Docker Compose 配置示例

yaml
version: '3.8'
services:
  custom-awx-ee:
    image: docker.xuanyuan.run/[镜像仓库地址]/custom-awx-ee:latest
    container_name: custom-awx-ee
    restart: unless-stopped
    environment:
      - ANSIBLE_VERBOSITY=2  # 设置Ansible输出详细级别（0-4）
      - HTTP_PROXY=http://proxy.example.com:8080  # 配置代理（如需）
      - HTTPS_PROXY=https://proxy.example.com:8080
    volumes:
      - ./ansible/playbooks:/ansible/playbooks:ro  # 只读挂载剧本目录
      - ./ansible/config:/etc/ansible:ro  # 只读挂载配置目录
      - ./custom-tools:/usr/local/bin:ro  # 挂载额外自定义工具

配置参数说明

环境变量

卷挂载推荐路径

注意事项

1. 依赖兼容性：定制依赖时需确保 Python 包、系统工具与镜像基础 Ansible 版本兼容，避免版本冲突导致任务执行失败。

2. 安全最佳实践：敏感配置（如 API 密钥、证书）建议通过环境变量或卷挂载注入，避免硬编码至镜像中；定期更新基础镜像以修复底层安全漏洞。

3. 镜像体积控制：定制工具和依赖时需评估必要性，避免过度集成导致镜像体积过大，影响拉取和部署效率。

4. 版本管理：建议通过标签（如 v1.0.0、dev-latest）区分镜像版本，便于回滚和多环境管理。