Jenkins 的安装与使用指南

一、Jenkins 安装部署

1. Docker 快速启动方案

docker run -d --name jenkins \
  -p 8080:8080 -p 50000:50000 \
  -v /home/dev/jenkins:/var/jenkins_home \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /usr/bin/docker:/usr/bin/docker \
  --restart=always \
  jenkins/jenkins:lts

参数说明：

  • 端口映射：8080（Web界面） / 50000（Agent通信）

  • 数据持久化：/var/jenkins_home 映射到宿主机目录

  • Docker集成：挂载 Docker 守护进程（需注意安全风险）

2. 初始化配置优化

(1) 加速插件下载

vim /home/dev/docker/app/jenkins/jenkins_home/hudson.model.UpdateCenter.xml 
将 URL内容修改为 https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json（清华大学官方镜像）
​
# 重启生效
docker restart jenkins

(2) 解锁 Jenkins

# 获取初始密码
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword

image-20250212163457378

(3) 插件安装建议

插件类型

必备插件推荐

基础功能

Pipeline、Git、SSH、Workspace Clean

容器化支持

Docker、Docker Pipeline

部署工具

Publish Over SSH、Deploy to container

新手建议直接选择--->安装推荐的插件即可

image-20250212163638120

二、SpringBoot 项目自动化部署实战

1. 环境准备

全局工具配置

  1. JDK：

    下载JDK安装包，移动到jenkins_home这个文件夹下，也就是启动时候挂载出来的文件夹下面，然后填写JDK地址，可以安装多个JDK，方便不同的项目使用

    image-20250212172115456

  2. Maven：

    Maven也是这样，配置下下载地址和仓库地址即可，然后jenkins在下图两个地方配置下

    image-20250213094107541

    image-20250213094118905

    # settings.xml 配置阿里云镜像
<mirror>
  <id>aliyunmaven</id>
  <mirrorOf>*</mirrorOf>
  <name>阿里云公共仓库</name>
  <url>https://maven.aliyun.com/repository/public</url>
</mirror>

  3. Docker：确保 Jenkins 容器有构建权限

2. 凭据管理

凭据类型

使用场景

配置方式

SSH密钥对

服务器登录

Jenkins -> 系统管理 -> System

Git账号密码

代码仓库认证

用户名密码类型

配置SSH服务器账号密码

image-20250213094934166

image-20250213095013987

3. 新建一个任务

image-20250213102217212

4. 制作Docker镜像

# 使用 OpenJDK 8 JRE Slim 版本（基于 Debian）
FROM openjdk:8-jre-slim
​
# 维护者信息
LABEL maintainer="lhl"
​
# 定义环境变量（可选）
ENV JAVA_OPTS="" \
    PARAMS="" \
    SPRING_CONFIG="application-test.yml"
​
# 创建应用目录
WORKDIR /app
​
# 运行时从挂载的 JAR 启动
ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS -jar app.jar --spring.config.location=$SPRING_CONFIG $PARAMS"]

文件目录可参考我的

image-20250213095155626

然后构建镜像

docker build -t big-market:latest .

运行容器

docker run -d \
  --name big-market \
  -v /home/dev/docker/app/java/big-market/application.yml:/app/config/application.yml \
  -v /home/dev/docker/app/java/big-market/big-market-app.jar:/app/app.jar \
  -v /home/dev/docker/app/java/big-market/log:/app/data/log \
  -v /etc/localtime:/etc/localtime:ro \
  -v /etc/timezone:/etc/timezone:ro \
  -e "JAVA_OPTS=-Xms512m -Xmx1024m -Dspring.config.location=/app/config/application.yml" \
  -p 8091:8091 \
  big-market:latest

5.jenkins配置

流程：拉取代码-->maven编译--->通过SSH发送jar包到指定服务器-->重启容器

image-20250213100205547

image-20250213100236862

image-20250213100258080

image-20250213100559446

三、最佳实践与排错指南

常见问题排查表

现象

可能原因

解决方案

插件下载失败

镜像源未生效

检查hudson.model.UpdateCenter.xml

SSH连接超时

服务器防火墙限制

检查22端口及密钥权限

Docker构建权限不足

用户组未添加docker

usermod -aG docker jenkins

流水线卡在Git阶段

凭据配置错误

重新配置SSH密钥

监控与优化建议

  1. 资源监控：安装Monitoring插件实时查看节点负载

  2. 并行构建：通过parallel指令加速流水线

  3. 镜像清理：定期执行docker system prune -f

通过本文档，您将获得从零搭建Jenkins CI/CD管道的完整能力。建议结合官方文档深入理解各组件工作原理，后续可扩展Kubernetes集成等进阶功能。