jgeusebroek/jenkins-docker

Docker Jenkins镜像（含Docker客户端，支持Docker-in-Docker）

镜像概述和主要用途

该镜像基于https://github.com/gliderlabs/docker-alpine%E5%92%8CJenkins%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%B7%B2%E9%A2%84%E8%A3%85Docker%E5%AE%A2%E6%88%B7%E7%AB%AF%EF%BC%8C%E6%94%AF%E6%8C%81Docker-in-Docker%EF%BC%88DinD%EF%BC%89%E5%8A%9F%E8%83%BD%EF%BC%8C%E5%85%81%E8%AE%B8%E5%9C%A8Jenkins%E7%8E%AF%E5%A2%83%E4%B8%AD%E7%9B%B4%E6%8E%A5%E6%89%A7%E8%A1%8CDocker%E5%91%BD%E4%BB%A4%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E9%9C%80%E8%A6%81%E5%9C%A8CI/CD%E6%B5%81%E7%A8%8B%E4%B8%AD%E6%9E%84%E5%BB%BA%E3%80%81%E6%8E%A8%E9%80%81Docker%E9%95%9C%E5%83%8F%E7%9A%84%E5%9C%BA%E6%99%AF%E3%80%82

核心功能和特性

• 轻量级基础：基于alpine Linux，镜像体积小，资源占用低
• Docker集成：内置Docker客户端，可直接在Jenkins任务中执行Docker命令
• 权限适配：支持通过环境变量配置用户UID，匹配宿主机Docker权限
• 标准Jenkins功能：包含Jenkins LTS版本的全部核心功能，支持插件扩展

使用场景和适用范围

• 需要在Jenkins Pipeline中构建Docker镜像的CI/CD流程
• 需在Jenkins任务中运行Docker容器进行应用测试的场景
• 希望简化Jenkins与Docker集成配置的开发/运维环境

使用方法和配置说明

环境变量

Docker部署示例

基本运行命令

bash
docker run -d --restart=always \
  --name=jenkins \
  -e JENKINS_UID=<宿主机具有Docker权限的用户UID> \
  -p 8080:8080 \
  -p 50000:50000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  jgeusebroek/jenkins-docker

参数说明

• -d：后台运行容器
• --restart=always：容器退出时自动重启
• --name=jenkins：指定容器名称为jenkins
• -e JENKINS_UID：设置Jenkins运行用户的UID，确保与宿主机Docker权限用户匹配
• -p 8080:8080：映射Jenkins Web界面端口
• -p 50000:50000：映射Jenkins代理通信端口
• -v /var/run/docker.sock:/var/run/docker.sock：挂载宿主机Docker套接字，实现Docker-in-Docker功能

注意事项

• 确保宿主机上指定的UID用户具有Docker操作权限（通常需加入docker用户组）
• 挂载/var/run/docker.sock是实现Docker-in-Docker的关键，需确保宿主机Docker服务正常运行
• 更多Jenkins使用细节请参考https://github.com/jenkinsci/docker/blob/master/README.md