核心是使用docker pull jenkins/jenkins:lts拉取官方lts镜像,通过docker run挂载数据卷和/var/run/docker.sock启动容器,并配置webhook触发pipeline实现ci/cd全流程。

用 Docker 搭建持续集成环境,核心是把 Jenkins 这类 CI 工具装进容器里,再配好构建、测试、部署所需的运行时和工具链。整个过程不依赖宿主机环境,启动快、迁移方便、配置可复用。
准备基础运行环境
确保服务器已安装 Docker,并能正常运行。推荐使用 CentOS 7+ 或 Ubuntu 20.04+ 系统。Docker 安装后建议配置国内镜像加速(如阿里云或腾讯云提供的加速地址),避免拉取镜像超时。Jenkins 官方镜像要求 Java 11 或 Java 17,宿主机无需预装 JDK,因为容器内自带;但若后续要在流水线中调用本地 Maven/Gradle/Node.js 等命令,则需在容器内或挂载宿主机对应工具链。
启动 Jenkins 容器
推荐使用官方 LTS 镜像,稳定性高:
-
拉取镜像:
docker pull jenkins/jenkins:lts -
创建数据卷或目录用于持久化:建议用
docker volume create jenkins-home,比直接挂载宿主目录更安全;若用目录,需确保其属主 UID 为 1000(Jenkins 容器默认用户 ID),否则启动失败 -
运行容器:
docker run -d --name jenkins -p 8080:8080 -p 50000:50000 -v jenkins-home:/var/jenkins_home -v /var/run/docker.sock:/var/run/docker.sock --restart=unless-stopped jenkins/jenkins:lts
注意挂载/var/run/docker.sock是为了让 Jenkins 能调用宿主机 Docker(用于构建镜像、运行测试容器等)
完成初始化与关键配置
访问 http://服务器IP:8080,按向导操作:
- 从容器日志或挂载目录中获取初始管理员密码:
docker logs jenkins | grep password或查看/var/lib/docker/volumes/jenkins-home/_data/secrets/initialAdminPassword - 安装推荐插件(含 Git、Pipeline、Docker Pipeline、Blue Ocean 等)
- 创建管理员账户
- 进入「系统配置」→「全局工具配置」,添加 JDK、Git、Maven、Node.js 等——这些可选装在容器内,也可通过挂载方式复用宿主机已安装版本
- 若需构建 Docker 镜像,确认已安装 Docker Pipeline 插件,并在流水线脚本中用
docker.build()或sh 'docker build ...'调用
接入代码仓库并定义流水线
以 GitHub 或 GitLab 为例:
- 在代码仓库设置 Webhook,指向 Jenkins 的
/generic-webhook-trigger/invoke(需安装 Generic Webhook Trigger 插件)或使用内置的 Git plugin + Poll SCM / webhook - 新建一个 Pipeline 类型任务,选择「Pipeline script from SCM」,填写仓库地址和 Jenkinsfile 路径(如
Jenkinsfile) - Jenkinsfile 示例(简版):
agent any
stages {
stage('Checkout') { steps { checkout scm } }
stage('Build') { steps { sh 'mvn clean package -DskipTests' } }
stage('Test') { steps { sh 'mvn test' } }
stage('Deploy') { steps { sh 'docker build -t myapp . && docker run -d -p 8081:8080 myapp' } }
}
}
实际项目中建议拆分构建、镜像推送、K8s 部署等步骤,并加入单元测试覆盖率、静态扫描等质量门禁。
不复杂但容易忽略:权限、挂载、网络连通性这三项出问题占调试时间八成以上。跑通一次后,整套环境可打包为 compose 文件或镜像模板,快速复用于其他项目。











