kwusen/ansible

Ansible 预装Docker镜像

镜像概述和主要用途

本镜像为一个轻量级Docker镜像，已预先安装Ansible自动化工具，旨在提供即开即用的Ansible运行环境。无需手动安装和配置Ansible依赖，可直接用于执行Ansible命令、运行playbook或进行自动化任务，适用于快速部署和测试自动化流程。

核心功能和特性

• 即开即用：已预装Ansible及必要依赖，无需额外配置即可使用
• 轻量级设计：基于精简基础镜像构建，减少资源占用
• 兼容性强：支持标准Ansible命令和playbook语法
• 灵活扩展：可通过挂载本地目录或配置文件自定义Ansible环境

使用场景和适用范围

• 快速验证Ansible playbook语法和功能
• 临时执行自动化配置管理任务
• CI/CD流程中集成Ansible自动化步骤
• 开发环境中的Ansible脚本测试
• 多环境一致性配置管理

使用方法和配置说明

基本使用（交互式模式）

bash
docker run -it --rm [镜像名称] ansible --version

挂载本地目录执行playbook

bash
docker run -it --rm -v /本地/playbook目录:/ansible \
  [镜像名称] ansible-playbook /ansible/your_playbook.yml

常用命令示例

• 检查Ansible版本：

  bash
  docker run --rm [镜像名称] ansible --version
  

• 执行ad-hoc命令：

  bash
  docker run --rm [镜像名称] ansible all -i "localhost," -c local -m ping
  

• 运行playbook：

  bash
  docker run --rm -v $(pwd):/ansible [镜像名称] ansible-playbook /ansible/site.yml
  

环境变量配置

Docker Compose配置示例

yaml
version: '3'
services:
  ansible:
    image: docker.xuanyuan.run/[镜像名称]
    volumes:
      - ./playbooks:/ansible/playbooks
      - ./inventory:/etc/ansible/hosts
    environment:
      - ANSIBLE_CONFIG=/ansible/ansible.cfg
    command: ansible-playbook /ansible/playbooks/deploy.yml

注意事项

• 运行涉及远程主机操作的playbook时，需确保容器网络可访问目标主机
• 敏感信息（如SSH密钥）建议通过挂载方式传入，避免硬编码在镜像中
• 如需持久化Ansible配置，可挂载本地配置目录到容器内对应路径