leakypixel/jenkins-docker

Jenkins-Docker镜像文档

镜像概述

本镜像为集成Docker的Jenkins镜像，旨在实现从Jenkins容器直接控制主机Docker守护进程，支持在CI/CD流程中通过Jenkins操作主机Docker资源（如构建镜像、运行容器等）。

核心功能与特性

• 内置Docker环境：镜像已预装Docker，无需额外安装即可使用Docker命令
• 主机Docker控制：通过挂载主机docker.sock，实现容器内Jenkins与主机Docker守护进程的交互
• 配置持久化：支持挂载/var/jenkins_home目录，实现Jenkins配置、插件和数据的持久化存储
• 时间同步：可挂载主机/etc/localtime，确保容器时间与主机一致

使用场景

• CI/CD流水线中需要通过Jenkins构建Docker镜像的场景
• 自动化部署流程中需从Jenkins容器管理主机Docker容器的环境
• 需要在Jenkins任务中执行Docker命令（如docker build、docker run）的场景

使用方法与配置说明

前置要求

• 主机已安装Docker和Docker Compose（若使用Compose部署）
• 获取主机Docker组ID（可通过getent group docker | cut -d: -f3命令获取）

1. Docker Run部署

bash
docker run -d \
  --name jenkins-docker \
  --restart unless-stopped \
  --group-add <主机Docker组ID> \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /path/to/your/config:/var/jenkins_home:rw \
  -v /etc/localtime:/etc/localtime:ro \
  leakypixel/jenkins-docker

2. Docker Compose部署

创建docker-compose.yml文件，内容如下：

yaml
jenkins:
  image: leakypixel/jenkins-docker
  restart: unless-stopped
  group_add:
    - "${DOCKER_GROUP}"  # 主机Docker组ID，可通过环境变量传入
  volumes:
    - "/var/run/docker.sock:/var/run/docker.sock"  # 挂载Docker套接字，实现主机Docker控制
    - /path/to/your/config:/var/jenkins_home:rw    # 持久化Jenkins配置（替换为实际路径）
    - "/etc/localtime:/etc/localtime:ro"           # 同步容器与主机时间

启动服务：

bash
# 替换<主机Docker组ID>为实际值
DOCKER_GROUP=<主机Docker组ID> docker-compose up -d

参数说明

验证部署

部署完成后，访问Jenkins Web界面（默认端口8080），在Jenkins任务中执行docker info命令，若能返回主机Docker信息，说明配置成功。