4oh4/jenkins-docker

jenkins-docker

镜像概述和主要用途

jenkins-docker是一个在Docker容器中运行的Jenkins镜像，内置Docker环境。通过容器化方式部署Jenkins可实现快速启动和环境隔离，同时支持在Jenkins中使用Docker运行测试用例或构建任务，确保构建环境的一致性和可控性。

相关博客文章提供更多信息：Quickstart CI with Jenkins and Docker-in-Docker

核心功能和特性

• 基于官方镜像：采用当前官方Jenkins长期支持（LTS）Docker镜像作为基础
• 内置Docker环境：在镜像中安装Docker CE，支持容器内使用Docker命令
• 用户权限配置：将jenkins用户添加到docker组，确保对Docker的操作权限
• 数据持久化：支持通过卷挂载实现Jenkins数据持久化，不受容器启停或删除影响
• Docker-in-Docker支持：通过连接主机Docker守护进程（而非运行独立Docker守护进程）实现更安全高效的Docker-in-Docker方案

使用场景和适用范围

适用于需要快速搭建CI/CD流程的场景，尤其是需要在Jenkins中运行Docker容器进行测试、构建或部署的场景。适合开发团队、DevOps工程师以及需要隔离构建环境的用户。

使用方法和配置说明

数据持久化

推荐在主机上创建显式卷以持久化Jenkins数据，确保数据在容器停止/重启/删除后仍能保留。运行容器时添加以下参数：

bash
-v jenkins_home:/var/jenkins_home

Docker-in-Docker配置

在容器中运行Docker时，建议连接主机系统的Docker守护进程（而非在容器内运行独立Docker守护进程），这样容器内的Docker CLI与主机的Docker CLI将连接到同一个Docker守护进程，避免潜在问题。运行容器时添加以下参数绑定挂载主机Docker守护进程：

bash
-v /var/run/docker.sock:/var/run/docker.sock

运行容器

从Docker Hub拉取镜像运行

bash
docker run -it -p 8080:8080 -p 50000:50000 \
    -v jenkins_home:/var/jenkins_home \
    -v /var/run/docker.sock:/var/run/docker.sock \
    --restart unless-stopped \
    docker.xuanyuan.run/4oh4/jenkins-docker

本地构建并运行

1. 克隆仓库并构建镜像：

bash
git clone <仓库地址>
cd jenkins-docker
docker build -t jenkins-docker .

2. 运行构建好的镜像：

bash
docker run -it -p 8080:8080 -p 50000:50000 \
    -v jenkins_home:/var/jenkins_home \
    -v /var/run/docker.sock:/var/run/docker.sock \
    --restart unless-stopped \
    docker.xuanyuan.run/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守护进程
• --restart unless-stopped：设置容器自动重启策略（除非手动停止）

许可证