Jenkins 流水线（Pipeline）详解

2024-05-27 08:04
文章标签 详解 流水线 jenkins pipeline

本文主要是介绍Jenkins 流水线（Pipeline）详解，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

        大家好，Jenkins 流水线（Pipeline）是一种可编排的持续集成和交付（CI/CD）方法，它以代码的方式定义整个软件开发过程中的构建、测试和部署流程。接下来就跟大家分享一下Jenkins 流水线（Pipeline）。

关于Jenkins安装可以参考：

使用Docker安装Jenkins

一、介绍

        Jenkins 流水线（Pipeline）是一种持续集成和交付（CI/CD）工具，它以代码的方式定义整个软件开发过程中的构建、测试和部署流程。与传统的 Jenkins 项目和自由风格项目相比，Jenkins 流水线具有以下显著特点和优势：

  1. 可编排性（Orchestration）： 流水线允许用户通过编写脚本来定义软件开发过程中的整个流程，包括构建、测试、部署等环节的顺序和依赖关系，实现了对整个流程的可编排性和可控性。

  2. 可追溯性（Traceability）： 流水线通过将整个软件开发过程的定义存储在版本控制系统中，实现了对每一次构建的全面追踪和记录，包括每个阶段的执行结果、日志输出等信息，方便用户进行问题排查和分析。

  3. 可重用性（Reusability）： 流水线通过提供一系列的 Pipeline DSL（Domain-Specific Language）来定义流水线的各个阶段和任务，使得用户可以编写可重用的模块和函数，方便流水线的复用和扩展。

  4. 可视化（Visualization）： 流水线提供了直观的可视化界面来展示流水线的执行过程和结果，包括阶段的执行状态、耗时、触发原因等信息，方便用户实时监控和管理流水线的运行情况。

  5. 灵活性（Flexibility）： 流水线允许用户根据具体的需求和场景定制和调整流水线的配置，包括添加、删除、修改阶段和任务，调整触发条件和参数配置等，实现了对流水线的灵活性和定制性。

        Jenkins 流水线为软件开发团队提供了一种灵活、可控、可视化的持续集成和交付解决方案，帮助团队更好地管理和优化软件开发过程，提高开发效率和质量。

二、Pipeline 插件

        Pipeline 插件是 Jenkins 中用于创建和管理流水线的核心插件，它提供了一种强大而灵活的方式来定义整个软件开发过程中的构建、测试和部署流程。

1、插件安装

        Pipeline 插件是 Jenkins 的默认安装插件之一，通常在安装 Jenkins 后就会自动包含。如果你的 Jenkins 没有安装 Pipeline 插件，可以通过 Jenkins 管理界面的插件管理功能进行安装。

2、Pipeline DSL

        Pipeline 插件引入了一种名为 Pipeline DSL（Domain-Specific Language）的脚本语言，它是基于 Groovy 语言的，并提供了一系列关键字和语法来定义流水线的各个阶段和任务。Pipeline DSL 主要包括以下几个核心概念：

  • pipeline：定义整个流水线的入口，包括流水线的名称、参数、触发条件等信息。
  • stage：定义流水线的一个阶段，包括阶段的名称、任务、并行执行等信息。
  • step：定义流水线的一个任务，可以是构建、测试、部署等操作。
  • node：指定流水线的执行节点，可以是 Jenkins 主节点或者代理节点。
  • agent：指定流水线的代理节点，即流水线的执行环境。
  • parameters：定义流水线的参数，可以在流水线执行时传入不同的参数值。

3、Pipeline 编写

编写 Pipeline 脚本通常分为以下几个步骤：

  1. 定义流水线：使用 pipeline 关键字定义流水线，并设置流水线的参数和触发条件。
  2. 定义阶段：使用 stage 关键字定义流水线的各个阶段，并设置阶段的名称和任务。
  3. 编写任务：在每个阶段中使用 steps 或其他任务相关的关键字来编写具体的任务脚本，如构建、测试、部署等。
  4. 设置代理节点：如果需要在特定的节点上执行任务，可以使用 agent 或 node 关键字来设置执行节点。
  5. 参数化：如果流水线需要接受外部参数，可以使用 parameters 关键字定义参数列表，并在流水线执行时传入参数值。

4、示例

下面是一个简单的 Pipeline 脚本示例，演示了一个简单的构建和测试流水线：

pipeline {agent anystages {stage('Build') {steps {sh 'mvn clean package'}}stage('Test') {steps {sh 'mvn test'}}}
}

        以上示例定义了一个包含两个阶段（Build 和 Test）的流水线，其中 Build 阶段用于执行 Maven 构建，Test 阶段用于执行 Maven 测试。这个示例演示了如何使用 Pipeline 插件来创建和管理流水线，以及如何编写简单的 Pipeline 脚本来定义流水线的各个阶段和任务。

三、Pipeline 脚本语法

        Pipeline 脚本语法是 Pipeline 插件提供的一种特定语法，用于编写 Jenkins 流水线的各个阶段和任务。

1、Stage（阶段）

Stage 是流水线中的一个逻辑单元，用于将流水线划分为不同的阶段，如构建、测试、部署等。

使用 stage 关键字定义一个阶段，并指定阶段的名称。

pipeline {agent anystages {stage('Build') {steps {// 构建步骤}}stage('Test') {steps {// 测试步骤}}// 更多阶段...}
}

2、Step（步骤）

Step 是流水线执行的最小单元，用于执行具体的任务，如构建项目、运行测试、发送通知等。

使用不同的关键字或函数来定义一个步骤，如 sh（执行 Shell 命令）、echo（输出信息）、git（Git 操作）等。

pipeline {agent anystages {stage('Build') {steps {sh 'mvn clean package'}}stage('Test') {steps {echo 'Running unit tests...'sh 'mvn test'}}// 更多步骤...}
}

3、Parallel（并行执行）

Parallel 允许将多个步骤或阶段并行执行，以提高流水线的执行效率。

使用 parallel 关键字将多个步骤或阶段包裹起来，并在其中定义需要并行执行的任务。

pipeline {agent anystages {stage('Test') {parallel {stage('Unit Tests') {steps {// 执行单元测试}}stage('Integration Tests') {steps {// 执行集成测试}}}}}
}

4、Node（节点）

Node 用于指定流水线的执行节点，即流水线的执行环境，可以是 Jenkins 主节点或代理节点。

使用 node 或 agent 关键字指定执行节点，并在其中定义流水线的各个阶段和任务。

pipeline {agent {label 'my-agent' // 指定代理节点}stages {stage('Build') {steps {// 构建步骤}}// 更多阶段...}
}

四、流水线基础

        在 Jenkins 中创建简单的流水线通常涉及以下几个步骤：定义流水线的结构、设置环境变量、编写脚本以及运行流水线。

1、定义流水线结构

首先需要定义流水线的结构，包括流水线的名称、代理节点、阶段和步骤等。

下面是一个简单的流水线定义示例，包括了一个构建阶段和一个测试阶段。

pipeline {agent any // 使用任意可用的代理节点stages {stage('Build') { // 定义构建阶段steps {echo 'Building...'sh 'make build'}}stage('Test') { // 定义测试阶段steps {echo 'Testing...'sh 'make test'}}}
}

2、设置环境变量

可以在流水线中设置环境变量，用于在流水线执行过程中传递参数、配置选项等。

下面示例演示了如何设置一个环境变量并在流水线的步骤中使用。

pipeline {agent anyenvironment {NAME = 'John' // 设置一个环境变量}stages {stage('Print') {steps {echo "Hello, ${NAME}!" // 使用环境变量}}}
}

3、编写流水线脚本

在流水线的各个阶段中编写脚本来实现具体的构建、测试、部署等任务。

下面示例展示了一个简单的流水线，其中包括了一个构建阶段和一个测试阶段，并在每个阶段中执行了一些命令。

pipeline {agent anystages {stage('Build') {steps {echo 'Building...'sh 'make build'}}stage('Test') {steps {echo 'Testing...'sh 'make test'}}}
}

4、运行流水线

        在 Jenkins 中，可以通过在 Jenkins 界面上选择相应的流水线项目并点击“构建”按钮来手动触发流水线的执行。也可以通过配置触发器来实现自动触发流水线的执行，如定时触发、代码提交触发等。

        手动触发流水线的执行通常在 Jenkins 界面上进行，点击流水线项目的“构建”按钮即可。自动触发流水线的执行需要在流水线项目的配置中配置相应的触发器，如下：

pipeline {triggers {cron('H/5 * * * *') // 每隔 5 分钟触发一次流水线执行}...
}

五、流水线高级特性

        在 Jenkins 中，流水线不仅可以实现简单的构建和测试任务，还可以利用一些高级特性来增强流水线的灵活性、可维护性和扩展性。下面详细介绍几种流水线的高级特性，并提供相应的示例代码。

1、参数化构建

参数化构建允许在流水线执行时传递参数值，使得流水线具有更大的灵活性。

下面是一个示例，演示了如何定义一个参数化的流水线，其中包括一个字符串类型的参数 ENVIRONMENT，用于指定环境名称。

pipeline {parameters {string(name: 'ENVIRONMENT', defaultValue: 'production', description: 'Environment name')}agent anystages {stage('Build') {steps {echo "Building for environment: ${params.ENVIRONMENT}"}}}
}

2、流水线共享库

流水线共享库允许将常用的流水线代码封装为可复用的库，并在多个流水线项目中共享和引用。

创建一个名为 vars 的目录，并在其中编写一个 Groovy 脚本文件（如 utils.groovy），定义一个名为 sayHello 的全局函数，然后在流水线脚本中引用该函数：

// vars/utils.groovy
def call() {echo 'Hello, world!'
}

// Jenkinsfile
@Library('my-shared-library') _
pipeline {agent anystages {stage('Test') {steps {utils.sayHello()}}}
}

3、异常处理

异常处理允许在流水线执行过程中捕获和处理异常情况，以实现更健壮的流水线。

下面示例展示了如何使用 try-catch 块来捕获异常，并在出现异常时执行相应的处理逻辑。

pipeline {agent anystages {stage('Deploy') {steps {script {try {sh 'deploy.sh'} catch (Exception e) {echo "Failed to deploy: ${e.message}"currentBuild.result = 'FAILURE'}}}}}
}

4、日志记录

日志记录允许在流水线执行过程中输出自定义的日志信息，以便在 Jenkins 界面中查看流水线的执行日志。

下面示例展示了如何使用 echo 函数输出自定义的日志信息。

pipeline {agent anystages {stage('Build') {steps {echo 'Building...'sh 'make build'}}}
}

六、与源代码管理集成

        将流水线与版本控制系统（如 Git、SVN 等）集成可以实现当代码发生变更时自动触发流水线的执行，从而实现持续集成和持续交付。

1、Git 集成

        Git 是目前最流行的版本控制系统之一，在 Jenkins 中配置 Git 集成可以实现当代码提交或分支变更时自动触发流水线的执行。

        下面是一个简单的流水线配置示例，其中包括了 Git 集成，使用了 checkout 步骤来拉取代码并切换到指定分支。

pipeline {agent anystages {stage('Checkout') {steps {checkout([$class: 'GitSCM', branches: [[name: 'master']], userRemoteConfigs: [[url: 'https://github.com/myuser/myrepo.git']]])}}stage('Build') {steps {sh 'make build'}}}
}

2、SVN 集成

        SVN 是另一种常用的版本控制系统，与 Git 类似，通过配置 SVN 集成可以实现当代码提交或分支变更时自动触发流水线的执行。

        下面是一个简单的流水线配置示例，其中包括了 SVN 集成，使用了 checkout 步骤来拉取代码并切换到指定路径。

pipeline {agent anystages {stage('Checkout') {steps {svn 'https://svn.example.com/svn/repo/trunk'}}stage('Build') {steps {sh 'make build'}}}
}

3、高级配置

        除了简单的拉取代码外，还可以配置更多高级选项，如指定分支、拉取代码的深度、使用认证信息等。

例如：

pipeline {agent anystages {stage('Checkout') {steps {git branch: 'main', credentialsId: 'my-git-credentials', url: 'https://github.com/myuser/myrepo.git'}}// 其他阶段...}
}

七、与测试框架集成

将流水线与测试框架集成可以实现自动执行测试并生成测试报告，从而实现持续集成和持续交付。

1、JUnit 集成

        JUnit 是 Java 平台上广泛使用的单元测试框架，通过配置 JUnit 集成可以在流水线执行过程中自动执行单元测试，并生成 JUnit 格式的测试报告。

        下面是一个简单的流水线配置示例，其中包括了 JUnit 集成，使用了 junit 步骤来执行单元测试并生成测试报告。

pipeline {agent anystages {stage('Build') {steps {sh 'make build'}}stage('Test') {steps {sh 'make test'}post {always {junit 'target/surefire-reports/*.xml'}}}}
}

2、TestNG 集成

        TestNG 是 Java 平台上的另一个流行的测试框架，与 JUnit 类似，通过配置 TestNG 集成可以在流水线执行过程中自动执行测试并生成测试报告。

        下面是一个简单的流水线配置示例，其中包括了 TestNG 集成，使用了 testng 步骤来执行测试并生成测试报告。

pipeline {agent anystages {stage('Build') {steps {sh 'make build'}}stage('Test') {steps {sh 'make test'}post {always {testng 'target/surefire-reports/*.xml'}}}}
}

3、Selenium 集成

        Selenium 是用于自动化 Web 应用程序测试的工具，通过配置 Selenium 集成可以在流水线执行过程中自动执行 Web UI 测试，并生成测试报告。

        下面是一个简单的流水线配置示例，其中包括了 Selenium 集成，使用了 sh 步骤来执行 Selenium 测试脚本。

pipeline {agent anystages {stage('Build') {steps {sh 'make build'}}stage('Test') {steps {sh 'make test'}post {always {sh 'python selenium_tests.py'}}}}
}

八、与部署工具集成

将流水线与部署工具集成可以实现自动化部署和发布，从而实现持续交付和持续部署。

此处将介绍两个常用的部署工具，具体可以参考：

Jenkins Pipeline常用插件整理

1、Docker 集成

        Docker 是一个流行的容器化平台，通过配置 Docker 集成可以在流水线执行过程中构建、打包和发布 Docker 镜像。

        下面是一个简单的流水线配置示例，其中包括了 Docker 集成，使用了 Docker Pipeline 插件提供的 docker.build 和 docker.push 步骤来构建和发布 Docker 镜像。

pipeline {agent anystages {stage('Build') {steps {script {docker.build('my-image:latest')}}}stage('Push') {steps {script {docker.withRegistry('https://docker.example.com', 'docker-credentials') {docker.image('my-image:latest').push()}}}}}
}

2、Kubernetes 集成

        Kubernetes 是一个开源的容器编排平台，通过配置 Kubernetes 集成可以在流水线执行过程中部署和管理容器化应用。

        下面是一个简单的流水线配置示例，其中包括了 Kubernetes 集成，使用了 Kubernetes Pipeline 插件提供的 kubectl 步骤来部署应用到 Kubernetes 集群。

pipeline {agent anystages {stage('Deploy') {steps {script {kubernetesDeploy(kubeconfigId: 'my-kube-config',configs: 'kube/*.yml')}}}}
}

这篇关于Jenkins 流水线（Pipeline）详解的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1006904。

相关文章

PHP轻松处理千万行数据的方法详解

PHP轻松处理千万行数据的方法详解

《PHP轻松处理千万行数据的方法详解》说到处理大数据集,PHP通常不是第一个想到的语言,但如果你曾经需要处理数百万行数据而不让服务器崩溃或内存耗尽,你就会知道PHP用对了工具有多强大,下面小编就... 目录问题的本质php 中的数据流处理：为什么必不可少生成器：内存高效的迭代方式流量控制：避免系统过载一次性
阅读更多...
MySQL的JDBC编程详解

MySQL的JDBC编程详解

《MySQL的JDBC编程详解》：本文主要介绍MySQL的JDBC编程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录前言一、前置知识1. 引入依赖2. 认识 url二、JDBC 操作流程1. JDBC 的写操作2. JDBC 的读操作总结前言本文介绍了mysq
阅读更多...
Redis 的 SUBSCRIBE命令详解

Redis 的 SUBSCRIBE命令详解

《Redis的SUBSCRIBE命令详解》Redis的SUBSCRIBE命令用于订阅一个或多个频道,以便接收发送到这些频道的消息,本文给大家介绍Redis的SUBSCRIBE命令,感兴趣的朋友跟随... 目录基本语法工作原理示例消息格式相关命令python 示例Redis 的 SUBSCRIBE 命令用于订
阅读更多...
使用Python批量将.ncm格式的音频文件转换为.mp3格式的实战详解

使用Python批量将.ncm格式的音频文件转换为.mp3格式的实战详解

《使用Python批量将.ncm格式的音频文件转换为.mp3格式的实战详解》本文详细介绍了如何使用Python通过ncmdump工具批量将.ncm音频转换为.mp3的步骤,包括安装、配置ffmpeg环... 目录1. 前言2. 安装 ncmdump3. 实现 .ncm 转 .mp34. 执行过程5. 执行结
阅读更多...
Python中 try / except / else / finally 异常处理方法详解

Python中 try / except / else / finally 异常处理方法详解

《Python中try/except/else/finally异常处理方法详解》：本文主要介绍Python中try/except/else/finally异常处理方法的相关资料,涵... 目录1. 基本结构2. 各部分的作用tryexceptelsefinally3. 执行流程总结4. 常见用法（1）多个e
阅读更多...
SpringBoot日志级别与日志分组详解

SpringBoot日志级别与日志分组详解

《SpringBoot日志级别与日志分组详解》文章介绍了日志级别（ALL至OFF）及其作用,说明SpringBoot默认日志级别为INFO,可通过application.properties调整全局或... 目录日志级别1、级别内容2、调整日志级别调整默认日志级别调整指定类的日志级别项目开发过程中，利用日志
阅读更多...
Java中的抽象类与abstract 关键字使用详解

Java中的抽象类与abstract 关键字使用详解

《Java中的抽象类与abstract关键字使用详解》：本文主要介绍Java中的抽象类与abstract关键字使用详解,本文通过实例代码给大家介绍的非常详细,感兴趣的朋友跟随小编一起看看吧... 目录一、抽象类的概念二、使用 abstract2.1 修饰类 => 抽象类2.2 修饰方法 => 抽象方法，没有
阅读更多...
MySQL8 密码强度评估与配置详解

MySQL8 密码强度评估与配置详解

《MySQL8密码强度评估与配置详解》MySQL8默认启用密码强度插件,实施MEDIUM策略（长度8、含数字/字母/特殊字符）,支持动态调整与配置文件设置,推荐使用STRONG策略并定期更新密码以提... 目录一、mysql 8 密码强度评估机制1.核心插件：validate_password2.密码策略级
阅读更多...
从入门到精通详解Python虚拟环境完全指南

从入门到精通详解Python虚拟环境完全指南

《从入门到精通详解Python虚拟环境完全指南》Python虚拟环境是一个独立的Python运行环境,它允许你为不同的项目创建隔离的Python环境,下面小编就来和大家详细介绍一下吧... 目录什么是python虚拟环境一、使用venv创建和管理虚拟环境1.1 创建虚拟环境1.2 激活虚拟环境1.3 验证虚
阅读更多...
详解python pycharm与cmd中制表符不一样

详解python pycharm与cmd中制表符不一样

《详解pythonpycharm与cmd中制表符不一样》本文主要介绍了pythonpycharm与cmd中制表符不一样,这个问题通常是因为PyCharm和命令行（CMD）使用的制表符（tab）的宽... 这个问题通常是因为PyCharm和命令行（CMD）使用的制表符（tab）的宽度不同导致的。在PyChar
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2