civicactions/docker-jenkins

Jenkins-Docker集成镜像文档

镜像概述

本镜像基于官方Jenkins镜像构建，预集成Docker引擎和docker-compose工具，解决标准Jenkins镜像中缺少Docker环境导致无法直接执行Docker相关操作的问题。适用于需要在CI/CD流程中集成Docker构建、容器化部署的场景，简化环境配置步骤，提升开发部署效率。

核心功能与特性

• 预安装Docker环境：包含完整Docker引擎，支持镜像拉取、构建、容器管理等标准Docker操作
• 集成docker-compose：内置docker-compose工具，支持多容器应用的编排与部署
• 无缝兼容Jenkins生态：保留官方Jenkins全部功能，可直接使用Jenkins插件、Pipeline等特性
• 权限优化：容器内Jenkins用户已配置适当权限，可直接访问宿主机Docker服务

使用场景

• 开发环境自动化构建：通过Jenkins Pipeline直接构建Docker镜像并推送至私有仓库
• 容器化应用部署：利用docker-compose实现多容器应用（如微服务架构）的一键部署
• CI/CD流水线集成：在构建流程中包含Docker镜像安全扫描、版本标记等Docker相关步骤
• 测试环境快速搭建：通过Jenkins任务自动创建包含特定依赖的Docker测试环境

使用方法

基础运行命令

bash
docker run -d \
  --name jenkins-docker \
  -p 8080:8080 \  # Jenkins Web界面端口
  -p 50000:50000 \  # Jenkins代理通信端口
  -v jenkins_home:/var/jenkins_home \  # 持久化Jenkins数据
  -v /var/run/docker.sock:/var/run/docker.sock \  # 共享宿主机Docker服务
  -v /usr/bin/docker:/usr/bin/docker \  # 挂载宿主机Docker可执行文件
  -v /usr/local/bin/docker-compose:/usr/local/bin/docker-compose \  # 挂载docker-compose
  your-image-name:tag

关键挂载说明

docker-compose配置示例

yaml
version: '3'
services:
  jenkins:
    image: your-image-name:tag
    container_name: jenkins-docker
    ports:
      - "8080:8080"
      - "50000:50000"
    volumes:
      - jenkins_home:/var/jenkins_home
      - /var/run/docker.sock:/var/run/docker.sock
      - /usr/bin/docker:/usr/bin/docker
      - /usr/local/bin/docker-compose:/usr/local/bin/docker-compose
    restart: always
    environment:
      - JENKINS_OPTS="--prefix=/jenkins"  # 配置访问路径前缀
      - JAVA_OPTS="-Xmx2048m"  # 调整JVM内存

volumes:
  jenkins_home:

配置说明

环境变量

安全注意事项

• 挂载/var/run/docker.sock会使容器获得宿主机Docker的root权限，生产环境建议：
  • 使用Docker-in-Docker (DinD)模式替代（需额外配置--privileged参数）
  • 限制Jenkins任务的权限范围，仅允许可信用户执行Docker操作

验证Docker环境

启动容器后，可通过以下步骤验证Docker环境：

1. 访问Jenkins Web界面（http://<主机IP>:8080）
2. 创建自由风格项目，添加"执行shell"构建步骤
3. 输入测试命令：

   bash
   docker --version
   docker-compose --version
   

4. 执行构建，查看控制台输出是否正常显示版本信息

维护与更新

• 数据备份：通过备份jenkins_home数据卷实现配置持久化
• 镜像更新：重新拉取新版本镜像后，需确保jenkins_home卷兼容新版本Jenkins
• 插件管理：通过Jenkins插件中心安装Docker相关插件（如Docker Pipeline、Docker Build Step）增强功能