如何在官方 Jenkins Docker 容器中不重建镜像安装 Ansible-Python教程-PHP中文网

如何在官方 Jenkins Docker 容器中不重建镜像安装 Ansible

官方 jenkins docker 镜像默认不含 ansible，ansible 插件仅支持配置已有安装路径，无法在运行时自动安装；需通过容器运行时挂载或初始化脚本方式注入 ansible 二进制文件，无需重建镜像。

官方 jenkins docker 镜像默认不含 ansible，ansible 插件仅支持配置已有安装路径，无法在运行时自动安装；需通过容器运行时挂载或初始化脚本方式注入 ansible 二进制文件，无需重建镜像。

Ansible 插件（jenkinsci/ansible-plugin）本身不提供自动安装 Ansible 的能力。其设计原则是安全隔离：插件仅作为执行协调层，依赖宿主机或容器内已预置的 ansible 可执行文件。README 明确指出：“There is no automatic ansible installation possible using Global Tools.” —— 即无法通过 Jenkins 的 Global Tool Configuration 或“Install plugin via script”等功能动态下载并安装 Ansible。

因此，所谓“在容器运行时安装 Ansible 而不重建镜像”，实质是在容器启动阶段（而非构建阶段）完成 Ansible 的部署。以下是两种经验证、生产友好的方案：

✅ 方案一：使用 `--init` + 启动脚本（推荐）

通过覆盖默认 entrypoint，在 Jenkins 主进程启动前安装 Ansible（基于 Alpine/Debian 基础镜像适配）：

# 不需新建 Dockerfile，直接运行时注入
docker run -d \
  --name jenkins-ansible \
  -p 8080:8080 -p 50000:50000 \
  -v jenkins_home:/var/jenkins_home \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --entrypoint sh \
  jenkins/jenkins:lts \
  -c "apk add --no-cache py3-pip && pip3 install --no-cache ansible && exec /usr/local/bin/jenkins.sh"

⚠️ 注意：jenkins/jenkins:lts 默认基于 Debian，若使用 jenkins/jenkins:jdk17（Alpine），请改用 apk add ansible；务必确认基础镜像系统类型。

Docker Cli
使用 Docker CLI 构建、运行、停止、检查和管理容器与镜像的助手。用于执行容器相关任务。

下载

✅ 方案二：挂载预装 Ansible 的目录（最安全）

在宿主机预先安装 Ansible，并通过卷挂载到容器内，再在 Jenkins 全局工具中指向该路径：

# 宿主机（Linux）安装 Ansible（建议使用用户级安装避免权限问题）
mkdir -p ~/ansible-runtime
python3 -m venv ~/ansible-runtime/venv
~/ansible-runtime/venv/bin/pip install ansible

# 启动 Jenkins 容器，挂载该目录
docker run -d \
  -v ~/ansible-runtime:/opt/ansible \
  -e JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64 \
  -p 8080:8080 \
  -v jenkins_home:/var/jenkins_home \
  jenkins/jenkins:lts

随后在 Jenkins 管理界面 → Global Tool Configuration → Ansible installations 中添加：

Name: ansible-2.16
Path to Ansible executable: /opt/ansible/venv/bin/ansible

❌ 不可行的做法

尝试在 Jenkins UI 中使用 “Install plugin via script” 安装 Ansible 二进制 —— 此功能仅适用于 Jenkins 插件（.hpi），不支持任意 CLI 工具安装；
在容器内通过 Jenkins Pipeline 执行 apt-get install ansible —— 失败率高（权限不足、包索引过期、APT 锁冲突），且违反不可变基础设施原则。

总结

Ansible 插件的本质是“连接器”，而非“安装器”。真正实现“不重建镜像”的关键是利用 Docker 的运行时能力（--entrypoint、-v 挂载）将 Ansible 注入容器生命周期早期。推荐优先采用方案二（挂载预装环境）：它解耦构建与运行、便于版本控制与审计，也完全符合 Jenkins 官方推荐的安全实践。