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

Jenkins Pipeline 构建 CI/CD 流程

news 来源：原创 2025/4/27 9:02:51

文章目录

    • jenkins 安装
    • jenkins 配置
    • jenkins 快速上手
      • 在 jenkins 中创建一个新的 Pipeline 作业
      • 配置Pipeline
      • 运行 Pipeline 作业
    • Pipeline
      • 概述
      • Declarative Pipeline
      • Scripted Pipeline

jenkins 安装

安装环境：

  • Linux CentOS 10：Linux CentOS9安装配置
  • Java 21：Java downloads
  • jenkins WAR 包：下载 Jenkins

官方给的下载方式很简单明了

在这里插入图片描述

此处博主的Jenkins 安装目录为：/home/fishpie/workspace/apps/

运行安装命令：

java -jar jenkins.war --httpPort=8080

在这里插入图片描述
如果遇到字体配置（Fontconfig）失败，可能是因为 linux 操作系统采用了最小化安装，缺失

  • fontconfig 包或相关字体
  • 缺少 libfontconfig 或其他图形依赖
SEVERE  hudson.util.BootFailure#publish: Failed to initialize Jenkins
java.lang.RuntimeException: Fontconfig head is null, check your fonts or fonts configuration

解决办法：

# 安装 fontconfig 和默认字体
sudo dnf install -y fontconfig dejavu-sans-fonts
# 安装图形相关依赖
sudo dnf install -y libX11 libXext libXrender libXtst libXi

另外如果出现 security 问题，需要注意系统时间是否正确

在这里插入图片描述
在这里插入图片描述

出现此页面证明Jenkins 安装完成，此时访问本机的 8080 端口即可访问 Jenkins

例如我本地装了 Jenkins 的机器：

http://192.168.156.129:8080/

在这里插入图片描述

jenkins 配置

密码登录进入后建议选择 安装推荐的插件

在这里插入图片描述

在这里插入图片描述

如果遇到插件安装错误可以多次尝试安装，可在
Manage Jenkins -> Plugins -> Download progress
中找到 安装完成后重启Jenkins 选项并勾选

正常的 jenkins 界面

在这里插入图片描述

jenkins 快速上手

前置环境：

  1. git
  2. docker
  3. 更新 OpenSSL 和 SSL 证书
# 安装或更新 OpenSSL
sudo dnf install -y openssl
# 更新 CA 证书
sudo dnf install -y ca-certificates
sudo update-ca-trust
  1. 安装 jenkins 的 docker pipline 插件

采用 github 项目 https://github.com/yeasy/simple-web 演示使用jenkins 构建和部署一个项目的完整过程

在 jenkins 中创建一个新的 Pipeline 作业

  1. 登录到你的 Jenkins 控制台。
  2. 在左侧菜单中点击 New Item（新建项目）。
  3. 输入作业名称，例如 SimpleWebPipeline。
  4. 选择 Pipeline（流水线）作为项目类型，然后点击 OK。

在这里插入图片描述
在这里插入图片描述

配置Pipeline

  1. 在作业配置页面，向下滚动到 Pipeline（流水线）部分。
  2. 在 Definition（定义）下拉菜单中，选择 Pipeline script（流水线脚本）。
  3. 在 Script（脚本）文本框中，粘贴以下 Jenkinsfile 代码：
pipeline {agent anystages {stage('Checkout') {steps {git 'https://github.com/yeasy/simple-web.git'}}stage('Build') {steps {script {// 验证 Docker 环境sh 'docker version'// 构建 Docker 镜像def image = docker.build("simple-web:latest")}}}stage('Deploy') {steps {script {// 停止并删除已存在的容器sh 'docker rm -f simple-web || true'// 运行新容器docker.image("simple-web:latest").run("-d -p 8081:80 --name simple-web")}}}}
}
  1. 点击 Save（保存）以保存作业配置。

在这里插入图片描述

运行 Pipeline 作业

  1. 在作业页面，点击 Build Now（立即构建）以启动流水线。
  2. 通过点击 Build History（构建历史）下的构建编号并选择 Console Output（控制台输出），监控构建过程。你将看到每个阶段（Checkout、Build、Deploy）的执行情况。

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

如果构建成功，则可在本机看到构建成功的镜像与进程

在这里插入图片描述

访问本机的 8081 端口可以正常看到网页

在这里插入图片描述

Pipeline

概述

Jenkins Pipeline（或简称为 “Pipeline”）是一套插件，将持续交付的实现和实施集成到 Jenkins 中

Jenkins Pipeline 有两种主要语法：

  • Declarative Pipeline：结构化、易读，适合大多数场景，推荐初学者使用。

  • Scripted Pipeline：基于 Groovy 语言，灵活但复杂，

Declarative Pipeline

固定结构，主要由 pipeline 块构成，包含以下核心部分：

  • agent：定义执行 Pipeline 的环境。
  • stages：定义一系列构建阶段。
  • steps：每个阶段的具体操作。
  • post：构建后的处理逻辑。

pipeline 块

  • 作用：pipeline 的根节点，包含整个流水线的定义
  • 要求：所有的 Declarative Pipeline 必须以 pipeline {} 开始
  • 示例：
pipeline {// 流水线内容
}

agent 指令

  • 作用：指定 pipeline或特定阶段运行的执行环境（节点或容器）
  • 常用选项：
    • any：可在任何节点上运行（默认）
    • none ：不指定全局代理，需要在每个 stage 中定义
    • docker ：在 Docker 容器中运行
    • label ：在带有特定标签的节点上运行
  • 示例：
// 表示 pipeline 在 jenkins 主节点或任意代理节点上运行
pipeline {agent any
}

//使用 Docker 容器运行
pipeline {agent {docker {image 'maven:3.6.3-jdk-11'args '-v /root/.m2:/root/.m2'}}
}
//在 Maven 容器中运行，挂载本地 Maven 缓存

stages 和 stage

  • 作用：
    • stages ：包含所有阶段的集合
    • stage ：定义单个阶段（如拉取代码、构建、部署）

可以把“步骤（step）”看作一个执行单一动作的单一的命令。 当一个步骤运行成功时继续运行下一个步骤。 当任何一个步骤执行失败时，Pipeline 的执行结果也为失败

当所有的步骤都执行完成并且为成功时，Pipeline 的执行结果为成功

  • 结构：
stages {stage('Stage Name') {steps {// 操作}}
}
  • 示例：
pipeline {agent anystages {stage('Checkout') {steps {git 'https://github.com/yeasy/simple-web.git'}}stage('Build') {steps {script {// 验证 Docker 环境sh 'docker version'// 构建 Docker 镜像def image = docker.build("simple-web:latest")}}}stage('Deploy') {steps {script {// 停止并删除已存在的容器sh 'docker rm -f simple-web || true'// 运行新容器docker.image("simple-web:latest").run("-d -p 8081:80 --name simple-web")}}}}
}
  • Checkout：从 github 克隆代码
  • Build：构建 Docker 镜像
  • Deploy：运行 Docker 容器

每个 stage 是一个逻辑单元，失败后会阻止后续阶段执行

阶段名称（如 Checkout）会显示在 Jenkins 的 Pipeline 视图中

节点名称可以自定义

steps 指令

  • 作用：定义阶段内的具体操作（如执行命令、调用插件）

  • 常用步骤：

    • sh ：执行 Linux、BSD 和 Mac OS（类 Unix ) 系统中的 shell 命令
    • bat ：执行 Windows 批处理命令
    • git ：拉取 Git 仓库代码
    • docker ：调用 Docker 命令（需要 Docker Pipeline 插件）
    • archiveArtifacts ：归档构建产物

    如果在 archiveArtifacts 步骤中指定了多个参数， 那么每个参数的名称必须在步骤代码中明确指定， 即文件的路径、文件名和 fingerprint 三个参数。 如果只需指定文件的路径和文件名， 那么可以省略参数名称 artifacts ，例如： archiveArtifacts 'build/libs/**/*.jar'

    • junit ：发布测试报告

  • 示例：

// 拉取指定 Git 仓库
steps {git 'https://github.com/yeasy/simple-web.git'
}

pipeline {agent anystages {stage('Build') {steps {sh './gradlew build'}}stage('Test') {steps {sh './gradlew check'}}}post {always {archiveArtifacts artifacts: 'build/libs/**/*.jar', fingerprint: truejunit 'build/reports/**/*.xml'}}
}

script 块

  • 作用：允许在 Declarative Pipeline 中嵌入 Scripted Pipeline 的 Groovy 代码，用于复杂逻辑
// 检查 docker 环境并构建镜像，负载操作采用 script 块包裹
steps {script {sh 'docker version'def image = docker.build("simple-web:latest")}
}

post 指令

  • 作用：钩子函数，定义构建完成后执行的操作，基于构建结果触发

  • 常用条件：

    • always ：无论成功或失败都执行
    • success ：构建成功时执行
    • failure ：构建失败时执行
    • unstable：构建不稳定时执行（如测试失败）

  • 示例：

// 如果构建成功则打包为 jar 包，否则发送指定邮件提醒
post {always {echo 'Pipeline finished!'}success {archiveArtifacts artifacts: '**/target/*.jar', allowEmptyArchive: true}failure {mail to: 'admin@example.com', subject: 'Build Failed', body: 'Check Jenkins for details.'}
}

pipeline {agent anystages {stage('No-op') {steps {sh 'ls'}}}post {always {echo 'One way or another, I have finished'deleteDir() /* clean up our workspace */}success {echo 'I succeeeded!'}unstable {echo 'I am unstable :/'}failure {echo 'I failed :('}changed {echo 'Things were different before...'}}
}

tools 指令

  • 作用：指定构建所需的工具版本（如 JDK、Maven），从 jenkins 全局工具配置中加载
  • 示例：
自动配置 Maven 和 JDK 环境
tools {maven 'Maven 3.6.3'jdk 'JDK 21'
}

需要在 Manage Jenkins > Tool 中预先配置工具

在这里插入图片描述

environment 指令

  • 作用：定义环境变量
  • 示例：
// 创建环境变量，相当于 Java 中的定义字符串
environment {DOCKER_IMAGE = 'simple-web:latest'APP_PORT = '8081'
}

// 引用上面的环境变量
sh "docker run -p ${APP_PORT}:80 ${DOCKER_IMAGE}"

同时，我们可以将 simple-web 的 pipeline 部分优化为：

environment {IMAGE_NAME = 'simple-web:latest'
}
stages {stage('Build') {steps {script {docker.build("${IMAGE_NAME}")}}}
}

when 指令

Java 语言的本性

  • 作用：控制阶段是否执行，基于条件判断
  • 示例：
stage('Deploy') {when {branch 'main'}steps {// 仅在 main 分支上部署}
}
  • 常用条件
    • branch ：指定分支
    • environment：检查环境变量
    • expression ：自定义 Groovy 表达式

try-catch

  • 作用：捕获并处理阶段失败，异常处理
  • 示例：
steps {script {try {sh 'make test'} catch (Exception e) {echo "Tests failed: ${e}"currentBuild.result = 'UNSTABLE'}}
}
// 执行 make test 命令，如果未能正常执行，则回显异常并设置当前构建结果为 UNSTABLE

retry-timeout

  • 作用：重复执行步骤直到成功（重试）和如果一个步骤执行花费的时间太长则退出
stage('Deploy') {steps {retry(3) {sh './flakey-deploy.sh'}timeout(time: 3, unit: 'MINUTES') {sh './health-check.sh'}}
}
// 在 Deploy 阶段重复执行 flakey-deploy.sh 脚本 3 次，然后等待 health-check.sh 脚本最长执行 3 分钟，如果 health-check.sh 超过 3 分钟内没有完成，pipeline 会标记此 Deploy 阶段为失败

Scripted Pipeline

Scripted Pipeline 是 Jenkins Pipeline 的另一种语法，基于 Groovy 语言，结构更自由但复杂

核心特点：

  • 使用 node 块定义执行环境
  • 直接编写 Groovy 代码，没有固定的 stages 或 steps 结构
  • 适合需要高度自定义的场景。

可以将上述的 jenkins 快速上手 中的 Declarative Pipeline 改写为 Scripted Pipeline

node {stage('Checkout') {git 'https://github.com/yeasy/simple-web.git'}stage('Build') {def image = docker.build("simple-web:latest")}stage('Deploy') {sh 'docker rm -f simple-web || true'docker.image("simple-web:latest").run("-d -p 8081:80 --name simple-web")}
}

Declarative Pipeline 与 Scripted Pipeline 的区别

特性Declarative PipelineScripted Pipeline
语法结构化，固定格式自由，基于 Groovy
易用性简单，适合初学者复杂，需熟悉 Groovy
可读性高，清晰的阶段划分较低，代码风格自由
灵活性有限，需用 script 块扩展高，完全自定义
错误处理内置错误检查需手动处理

相关文章：

  • Promethues 普罗米修斯
  • 【Linux篇】理解信号：如何通过信号让程序听从操作系统的指令
  • Memcached 主主复制架构搭建与 Keepalived 高可用实现
  • 9.ArkUI List的介绍和使用
  • MCP认证考试技术难题实战破解：从IP冲突到PowerShell命令的深度指南
  • Flutter Dart中的类 对象
  • 第四代北斗系统发展现状分析
  • QQ音乐安卓版歌曲版权覆盖范围与曲库完整度评测
  • IDEA编写flinkSQL（快速体验版本，--无需配置环境）
  • 在Python中设置现有Word文档的缩进
  • 红队系列-网络安全知识锦囊-CTF(持续更新)
  • netlist
  • Linux 官方蓝牙协议栈 BlueZ 第一篇：入门与架构概览
  • 【Linux网络】TCP服务中IOService应用与实现
  • pnpm常见报错解决办法
  • JMeter添加HTTP请求默认值元件的作用详解
  • PicoVR眼镜在XR融合现实显示模式下无法显示粒子问题
  • 欧拉计划 Project Euler56（幂的数字和）题解
  • pnpm monoreop 打包时 node_modules 内部包 typescript 不能推导出类型报错
  • firewalld 详解
  • 铜钴巨头洛阳钼业一季度净利润同比大增九成，最新宣布首度进军黄金矿产
  • 蚂蚁集团将向全体股东分红
  • 全国首例！上市公司董监高未履行公开增持承诺，投资者起诉获赔
  • 11-13世纪的地中海贸易
  • 上海黄浦一季度实到外资总量全市第二，同比增速领先全市
  • 中国牵头制定，在线旅游机构和展览与活动领域ISO国际标准发布