Jenkins 简易使用记录

一、Jenkins 核心功能与适用场景

核心功能：
- 持续集成（CI）：自动构建代码、运行单元测试。
- 持续交付（CD）：自动化部署到测试/生产环境。
- 任务调度：定时执行任务（如备份、清理）。
- 插件生态：支持 1,500+ 插件（Git、Docker、Kubernetes 等）。
适用场景：
- 自动化测试：每次提交后自动运行测试。
- 多环境部署：一键发布到开发、测试、生产环境。
- 微服务架构：并行构建多个服务。
- 跨团队协作：通过流水线规范开发流程。

二、Jenkins 使用流程（通用步骤）

安装与配置：
- 通过 Docker 或原生安装（推荐 Docker 简化依赖）：
```
docker run -d -p 8080:8080 -p 50000:50000 -v jenkins_home:/var/jenkins_home jenkins/jenkins:lts
```
- 初始化后安装常用插件：Git、Pipeline、SSH。
创建任务：
- 自由风格项目：适合简单任务。
- Pipeline 项目：通过 Jenkinsfile 定义复杂流程（推荐）。

三、Spring Boot 项目部署示例

场景：将 Spring Boot 项目构建为 JAR 包并部署到 Linux 服务器。

Jenkins 配置：
- 凭据管理：添加 Git 仓库的 SSH 密钥和服务器 SSH 账号。
- 安装插件：Maven Integration、Publish Over SSH。

Pipeline 脚本（Jenkinsfile）：

pipeline {agent anystages {stage('Checkout') {steps {git url: 'git@github.com:your/spring-boot-repo.git', branch: 'main'}}stage('Build') {steps {sh 'mvn clean package -DskipTests'}}stage('Deploy') {steps {sshPublisher(publishers: [sshPublisherDesc(configName: 'prod-server',transfers: [sshTransfer(sourceFiles: 'target/*.jar',removePrefix: 'target/',remoteDirectory: '/opt/app',execCommand: 'sudo systemctl restart springboot-app')])])}}}
}

服务器准备：

创建 Systemd 服务文件 /etc/systemd/system/springboot-app.service：

[Unit]
Description=Spring Boot App
After=network.target[Service]
ExecStart=/usr/bin/java -jar /opt/app/your-app.jar
User=appuser
Restart=always[Install]
WantedBy=multi-user.target

四、Vue 项目部署示例

场景：构建 Vue 静态文件并部署到 Nginx 服务器。

Pipeline 脚本（Jenkinsfile）：

pipeline {agent anystages {stage('Checkout') {steps {git url: 'git@github.com:your/vue-project.git', branch: 'main'}}stage('Build') {steps {sh 'npm install'sh 'npm run build'}}stage('Deploy') {steps {sshPublisher(publishers: [sshPublisherDesc(configName: 'frontend-server',transfers: [sshTransfer(sourceFiles: 'dist/**',remoteDirectory: '/usr/share/nginx/html',execCommand: 'sudo systemctl reload nginx')])])}}}
}

服务器配置：
- 确保 Nginx 配置指向 /usr/share/nginx/html：
```
server {listen 80;root /usr/share/nginx/html;index index.html;
}
```

五、最佳实践与建议

Pipeline 优化：
- 将 Jenkinsfile 纳入代码仓库，实现“流水线即代码”。
- 使用 parallel 阶段加速多模块构建。
安全与维护：
- 敏感信息管理：使用 Jenkins 的 Credentials Binding 插件注入密码。
- 镜像仓库集成：结合 Docker 构建镜像并推送到 Harbor 或 Docker Hub。
- 回滚机制：通过版本号或 Git Tag 快速回退。
高级场景：
- Kubernetes 部署：使用 Jenkins Kubernetes 插件动态创建 Pod。
- 多环境配置：通过参数化构建选择环境（dev/test/prod）。