ashish1981/multiarch-jenkins

Jenkins with Ansible 镜像文档

镜像概述

本镜像基于Jenkins官方基础镜像构建（参考：https://github.com/jenkinsci/docker/blob/master/README.md%EF%BC%89%EF%BC%8C%E5%B9%B6%E9%A2%9D%E5%A4%96%E9%9B%86%E6%88%90%E4%BA%86Python%E5%92%8CAnsible%E5%B7%A5%E5%85%B7%EF%BC%8C%E6%97%A8%E5%9C%A8%E4%B8%BACI/CD%E6%B5%81%E7%A8%8B%E6%8F%90%E4%BE%9B%E4%B8%80%E7%AB%99%E5%BC%8F%E7%9A%84%E8%87%AA%E5%8A%A8%E5%8C%96%E9%83%A8%E7%BD%B2%E8%83%BD%E5%8A%9B%EF%BC%8C%E6%97%A0%E9%9C%80%E5%9C%A8%E5%AE%B9%E5%99%A8%E5%86%85%E9%83%A8%E5%8D%95%E7%8B%AC%E5%AE%89%E8%A3%85Ansible%E7%8E%AF%E5%A2%83%E3%80%82

核心功能和特性

• 基于官方Jenkins：保留Jenkins全部原生功能，支持插件安装、流水线配置等CI/CD核心能力
• 集成Python环境：提供Python运行环境，满足Ansible依赖及其他Python脚本执行需求
• 预装Ansible：内置Ansible工具，可直接在Jenkins任务中调用ansible或ansible-playbook命令
• 兼容性：与Jenkins官方镜像保持版本兼容，支持官方文档中的配置方式

使用场景和适用范围

• 需要在CI/CD流水线中执行Ansible自动化部署的场景
• 需通过Jenkins触发Ansible playbook进行服务器配置管理的场景
• 希望简化Jenkins容器中Ansible环境搭建流程的开发/运维团队

使用方法和配置说明

基本运行命令

bash
docker run -d -p 8080:8080 -p 50000:50000 --name jenkins-ansible jenkins-ansible

持久化数据存储

为避免容器重启后数据丢失，建议挂载Jenkins数据目录：

bash
docker run -d -p 8080:8080 -p 50000:50000 \
  -v /your/local/jenkins_home:/var/jenkins_home \
  --name jenkins-ansible jenkins-ansible

环境变量配置

支持Jenkins官方镜像的所有环境变量，例如：

• JENKINS_OPTS：自定义Jenkins启动参数
• JENKINS_SLAVE_AGENT_PORT：修改从节点代理端口
• JAVA_OPTS：设置JVM参数

示例：

bash
docker run -d -p 8080:8080 -p 50000:50000 \
  -e JENKINS_OPTS="--prefix=/jenkins" \
  -e JAVA_OPTS="-Xmx2g" \
  --name jenkins-ansible jenkins-ansible

在Jenkins任务中使用Ansible

1. 登录Jenkins控制台，创建新任务（自由风格或流水线）
2. 在构建步骤中添加"执行shell"（自由风格）或在流水线脚本中使用sh步骤
3. 直接调用Ansible命令，例如：

   bash
   ansible-playbook -i inventory.yml deploy.yml
   

注意事项

• 首次启动时需通过日志获取初始管理员密码：docker logs jenkins-ansible
• 如需使用Ansible连接外部主机，需在容器内配置SSH密钥或密码认证
• 建议根据实际需求调整容器资源限制（如内存、CPU）