当前位置：首页 > news >正文

使用Docker安装Jenkins：完整指南与最佳实践

news 2025/10/29 8:28:08

在当今快速发展的软件开发领域，持续集成与持续部署（CI/CD）已成为提高开发效率、保证软件质量的关键环节。而Jenkins作为最流行的开源自动化服务器，与Docker容器技术的结合，为构建稳定、可重复的自动化流程提供了完美解决方案。

前言

Jenkins是一款开源的持续集成工具，广泛用于项目开发，能提供自动构建、测试和部署等功能。作为领先的开源自动化服务器，Jenkins提供了数百个插件来支持构建、部署和自动化任何项目。

结合Docker使用Jenkins可以带来诸多好处：

环境一致性：避免因环境差异导致构建失败
快速部署：容器化的Jenkins可以快速启动和迁移
资源隔离：容器间的相互隔离提高安全性
易于管理：通过Docker命令简化运维操作

安装准备

在开始安装前，请确保您的系统已安装Docker引擎。可以使用以下命令检查Docker是否已安装：

bash

docker --version

如果未安装Docker，请先参考官方文档安装Docker引擎。

安装Jenkins

1. 拉取Jenkins镜像

目前常用的Jenkins镜像有两个主要版本：

bash

# 官方Jenkins镜像
docker pull jenkins/jenkins:lts# 或Blue Ocean镜像（包含直观的流水线UI）
docker pull jenkinsci/blueocean[citation:3][citation:8]

2. 创建数据卷目录

为了持久化Jenkins数据，需要创建宿主机目录并设置适当权限：

bash

# 创建目录
sudo mkdir -p /var/jenkins_home# 设置权限（Jenkins容器内默认使用1000用户运行）
sudo chown -R 1000:1000 /var/jenkins_home# 或者使用更宽松的权限（适合测试环境）
sudo chmod 777 /var/jenkins_home[citation:6][citation:7]

3. 运行Jenkins容器

使用以下命令启动Jenkins容器：

bash

docker run -d \-p 8080:8080 -p 50000:50000 \-v /var/jenkins_home:/var/jenkins_home \-v /var/run/docker.sock:/var/run/docker.sock \-v /etc/localtime:/etc/localtime \--name jenkins \--privileged=true \jenkins/jenkins:lts[citation:3][citation:6]

参数说明：

-d：后台运行容器
-p 8080:8080：将容器8080端口映射到宿主机8080端口（Web界面）
-p 50000:50000：Jenkins代理通信端口
-v /var/jenkins_home:/var/jenkins_home：数据持久化
-v /var/run/docker.sock:/var/run/docker.sock：允许容器内使用Docker命令
-v /etc/localtime:/etc/localtime：同步宿主机时间
--privileged=true：授予容器特权（需在生产环境中谨慎使用）

4. 验证安装

检查容器是否正常运行：

bash

docker ps

查看容器日志：

bash

docker logs jenkins

初始化配置

1. 访问Jenkins

打开浏览器，访问 http://<你的服务器IP>:8080，将看到Jenkins解锁界面。

2. 获取初始密码

Jenkins第一次启动时会生成一个随机管理员密码，可以通过以下方式查看：

bash

# 方式一：从宿主机查看
cat /var/jenkins_home/secrets/initialAdminPassword# 方式二：进入容器查看
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword[citation:7][citation:8]

3. 安装插件

选择"安装推荐的插件"，Jenkins将自动安装最常用的插件集。

加速插件安装：
国内用户可能会遇到插件下载慢的问题，可以通过更换更新中心解决：

编辑 /var/jenkins_home/hudson.model.UpdateCenter.xml
将url改为清华大学镜像源：

xml

<?xml version='1.1' encoding='UTF-8'?>
<sites><site><id>default</id><url>https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json</url></site>
</sites>[citation:5][citation:8]

重启Jenkins容器：docker restart jenkins

4. 创建管理员账户

插件安装完成后，创建第一个管理员用户，填写必要信息即可完成初始化。

基础配置

配置JDK环境

使用Docker安装的Jenkins容器内通常已包含JDK，但需要在Jenkins系统中配置：

进入 Manage Jenkins > Global Tool Configuration
找到JDK部分，取消"自动安装"，手动设置JAVA_HOME路径
对于jenkinsci/blueocean镜像，JDK路径一般为：/opt/java/openjdk
保存配置

配置Maven

在 Global Tool Configuration 页面找到Maven部分
点击"新增Maven"，输入名称如"Maven 3.6.3"
取消"自动安装"，设置MAVEN_HOME路径（如已手动安装）
或勾选"自动安装"，选择所需版本

安装常用插件

除了初始安装的插件，还需安装一些常用插件：

Maven Integration：Maven项目支持
Pipeline：流水线功能
Git：Git版本控制
Publish Over SSH：远程部署

使用Docker内的Docker

有时需要在Jenkins流水线中执行Docker命令，有以下两种方案：

方案一：挂载Docker套接字（推荐）

启动容器时添加参数：

bash

-v /var/run/docker.sock:/var/run/docker.sock[citation:3][citation:5]

这样容器内可以直接使用宿主机的Docker引擎。

方案二：Docker in Docker（DinD）

在Jenkins容器内安装Docker客户端：

bash

# 进入容器
docker exec -it jenkins bash# 安装Docker客户端
apt-get update
apt-get install -y docker.io[citation:3]

基本使用示例

创建第一个流水线项目

点击"新建任务"，输入任务名称，选择"流水线"
在流水线部分，可以选择"Pipeline script"直接编写脚本，或从SCM获取
以下是一个简单的流水线示例：

groovy

pipeline {agent anytools {maven 'maven-3.6.3'}stages {stage('Build') {steps {sh 'mvn clean package -DskipTests'}}stage('Docker Build') {steps {script {docker.build("my-app:${env.BUILD_NUMBER}")}}}}
}[citation:5]

配置自动化部署

结合SSH插件可以实现自动化部署：

groovy

pipeline {agent anystages {stage('Deploy') {steps {sshPublisher(publishers: [sshPublisherDesc(configName: 'production-server',transfers: [sshTransfer(sourceFiles: 'target/*.jar',removePrefix: 'target',remoteDirectory: '/app')],execCommand: 'cd /app && ./restart.sh')])}}}
}