foxylion/jenkins

docker-jenkins 镜像文档

镜像概述和主要用途

该项目旨在构建预配置的Jenkins 2 Docker镜像，提供运行全Docker支持的Jenkins所需的所有插件，支持多Docker从节点和Docker Pipeline插件，适用于快速部署Docker环境下的Jenkins主从架构。

核心功能和特性

• 预配置Jenkins 2，包含Docker流水线所需全部插件
• 提供Blueocean流水线视图
• 支持两种从节点模式：SSH和JNLP
• 从节点支持Docker socket挂载，实现Docker-in-Docker能力
• 灵活的认证配置（密钥/密码）
• 临时从节点自动创建和清理功能

Docker镜像类型

Docker Hub上提供三个镜像：Jenkins主节点、SSH从节点和JNLP从节点。

Jenkins主节点

最新镜像可在https://hub.docker.com/r/foxylion/jenkins/%E8%8E%B7%E5%8F%96%E3%80%82

Jenkins主节点镜像提供预配置的Jenkins 2版本，包含运行Docker流水线所需的所有插件，并集成新的Blueocean流水线视图。

Jenkins主节点需暴露HTTP端口和从节点通信端口。

bash
docker run -d --name jenkins -p 80:8080 -p 50000:50000 \
           -v /var/lib/jenkins:/var/jenkins_home \
           foxylion/jenkins

• 启动新的Jenkins主节点
• 监听80端口接收HTTP请求
• 默认认证凭据：admin/admin
• 可通过JENKINS_PASS环境变量修改密码
• 所有配置保存到/var/lib/jenkins

移除-v参数会阻止容器向主机文件系统写入数据，但容器删除时可能导致数据丢失。

Jenkins SSH从节点

最新镜像可在https://hub.docker.com/r/foxylion/jenkins-ssh-slave/%E8%8E%B7%E5%8F%96%E3%80%82

Jenkins SSH从节点镜像是轻量级解决方案，可在任何Docker启用的服务器上零依赖运行Jenkins从节点。其设计理念是在Docker主机上运行容器，暴露SSH服务器供Jenkins主节点连接。镜像支持配置可信SSH密钥或密码认证。

bash
docker run -d --name jenkins-slave --restart=unless-stopped \
           -p 2222:22 \
           -v /home/jenkins:/home/jenkins \
           -v /var/run/docker.sock:/var/run/docker.sock \
           -e SSH_KEY="ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC6CPOQDrq...faMvvidd+RVSfDBgJE1g3 jenkins@jenkins.company.tld" \
           foxylion/jenkins-ssh-slave

在Jenkins主节点上配置新节点时需注意：

• 使用自定义端口（示例中为2222），可在节点配置页面的"高级..."选项中设置
• Jenkins用于认证从节点的用户为root
• 工作目录为/home/jenkins
• 必须选择"手动可信密钥验证策略"并勾选"Require manual verification of initial connection"，否则主节点无法连接从节点
• 可通过docker logs jenkins-slave获取从节点指纹并进行比对

以下环境变量可自定义从节点行为：

Jenkins JNLP从节点

最新镜像可在https://hub.docker.com/r/foxylion/jenkins-slave/%E8%8E%B7%E5%8F%96%E3%80%82

Jenkins JNLP从节点镜像提供可配置的Jenkins从节点版本，支持凭据或JNLP从节点密钥认证。从节点容器启动时可自动创建节点，容器停止时自动移除节点。

bash
docker run -d --name jenkins-slave --restart=unless-stopped \
           -v /home/jenkins:/home/jenkins \
           -v /var/run/docker.sock:/var/run/docker.sock \
           -e JENKINS_URL=https://jenkins.mycompany.com \
           foxylion/jenkins-slave

默认情况下，从节点会自动创建临时Jenkins节点，名称由前缀docker-slave和容器主机名组成。

注意：JNLP从节点与主节点通信时不提供加密，不建议在不可信网络中使用。建议改用SSH从节点镜像。

以下环境变量可自定义从节点行为：

临时从节点

当SLAVE_NAME环境变量留空时启用临时从节点功能。从节点会自动创建具有生成名称的新Jenkins节点，从节点关闭后Jenkins节点会被删除。如需避免此行为，使用持久从节点。

持久从节点

运行不自动创建Jenkins节点但使用JNLP从节点认证的从节点。

注意：必须将从节点的"远程根目录"设置为/home/jenkins。

bash
docker run -d \
           -v /home/jenkins:/home/jenkins \
           -v /var/run/docker.sock:/var/run/docker.sock \
           -e JENKINS_URL=http://jenkins.mycompany.com \
           -e SLAVE_NAME=docker-slave-028 \
           foxylion/jenkins-slave

更改"远程根目录"

默认情况下，Jenkins从节点要求/home/jenkins挂载到Docker主机上的等效目录。

注意：主机上使用不同的目录路径会导致构建失败。了解更多（章节："在容器内运行构建步骤"）

如需在Docker主机上使用不同目录，可在启动容器时指定：

bash
docker run -d \
           -w /tmp/jenkins-slave \
           -v /tmp/jenkins-slave:/tmp/jenkins-slave \
           -v /var/run/docker.sock:/var/run/docker.sock \
           -e JENKINS_URL=http://jenkins.mycompany.com \
           foxylion/jenkins-slave

扩展阅读

以下链接有助于开始使用Jenkins流水线与Docker结合：

• Jenkins流水线入门，包括步骤、阶段、stash、docker
• https://wilsonmar.github.io/jenkins2-pipeline/