---
  title: Jenkins部署和使用
  date: 2025-11-26
---

# 一、Jenkins安装
## 1.1 简介
  Jenkins 是一款开源的持续集成（Continuous Integration, CI） 和持续交付（Continuous Delivery, CD） 自动化工具，广泛应用于软件开发流程中，帮助团队实现代码构建、测试、部署的自动化，从而提升开发效率、减少人为错误，并确保软件质量。

## 1.2 下载使用
1. 打开[官网](https://www.jenkins.io/zh/)，选择版本下载（本文版本为Version 2.504.2）。
2. 输入指令直接启动：
```cmd
java -jar jenkins.war
```
  第一次需要输入密码，在控制台中可以看到。

## 1.3 系统服务启动
1. 将jenkins.war复制到相应位置，例/usr/share/jenkins/jenkins.war
2. 在/etc/systemd/system中新建系统服务文件 jenkins.service：
```service
[Unit]
Description=Jenkins Continuous Integration Server
After=network.target

[Service]
Type=simple
User=root
Group=root
ExecStart=/usr/bin/java -jar /usr/share/jenkins/jenkins.war
Restart=always

[Install]
WantedBy=multi-user.target
```
3. 如需配置Nginx反向代理，ExecStart启动命令后增加配置信息：
```cmd
ExecStart=/usr/bin/java -jar /usr/share/jenkins/jenkins.war --httpPort=9090 --prefix=/jenkins
```
4. 更改nginx配置文件：
```cmd
server {
  listen 80 default_server;
	listen [::]:80 default_server;

  # Jenkins服务
  location /jenkins {
    proxy_pass http://127.0.0.1:9090/jenkins;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
		proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
		proxy_set_header X-Forwarded-Proto $scheme;
  }
}
```
  这里的代理端口号需要和ExecStart启动命令的端口号一致。
5. 重启服务：
```cmd
sudo nginx -s reload
systemctl daemon-reload 
systemctl restart jenkins.service
```

## 1.4 插件安装和配置
  选择Dashboard -> Manage Jenkins ->  Plugins，安装Maven、Node、Gitee等插件。

### 1.4.1 配置JDK
1. 安装Java JDK 17，例：`sudo apt install openjdk-17-jdk`
2. 选择Dashboard -> Manage Jenkins -> Tools，点击Add JDK，输入Name和JAVA_HOME
```cmd
Name: JDK 17
JAVA_HOME: /usr/lib/jvm/java-17-openjdk-amd64
```
  注：根据实际情况修改，下同。

### 1.4.2 配置Maven
1. 官网下载Maven压缩包，解压至/opt目录
2. 选择Dashboard -> Manage Jenkins -> Tools，点击Add Maven，输入Name和Maven_HOME
```cmd
Name: Maven3.9.10
Maven_HOME: /opt/apache-maven-3.9.10
```

### 1.4.3 配置NodeJS
1. 官网下载NodeJS压缩包，解压至/opt目录
2. 选择Dashboard -> Manage Jenkins -> Tools，点击Add Node，输入Name和Installation directory
```cmd
Name: Node20.10.0
Installation directory: /opt/node-v20.10.0-linux-x64
```

### 1.4.4 配置Gitee
  选择Dashboard -> Manage Jenkins -> System，选择Gitee Configuration，输入name和URL，点击Add Credentials，选择Kind的Gitee API token，将Gitee中生成的token复制到指定位置。  
  注：该版本新增的Gitee Token并不能在后续的项目中找到，但是又无法新增username和password形式，只能在项目的gitee配置中新增username和password的形式，不知道是什么原因？

# 二、创建工程
## 2.1 创建Maven工程
1. 选择Dashboard -> New Item
2. 输入项目名称
3. 选择Maven Project
4. 


## Springboot项目
```cmd
BUILD_ID=dontKillMe
cp /home/estun/.jenkins/workspace/sweet-hut-service/home-service/target/home-service-2.0.0.jar /home/estun/EdgeProjects/sweet-hut-service
cd /home/estun/EdgeProjects/sweet-hut-service
sh spring-service.sh restart home-service-2.0.0.jar
```

## Vue3项目
```cmd
npm install 
npm run build
cp -rf ./dist/* /home/estun/EdgeProjects/sweet-hut-ui
```