Jenkins Pipline实现及原理示例解析

 更新时间:2023年07月28日 17:33:21   作者:罗_宇  
这篇文章主要为大家介绍了Jenkins Pipline实现及原理示例解析,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪

Jenkins-Pipline原理

本文仅探讨jenkins pipline 的原理,是流水线的一个demo版本实现,不能代表Jenkins pipline的具体实现,仅供参考。

1. Jenkins流水线介绍

Jenkinsfile流水线是Jenkins CI/CD工具中用来定义、构建和管理软件交付流程的一种声明式文件。

它允许将整个软件交付流程以代码的形式进行描述,从而实现对软件交付过程的可追踪性、可维护性和可扩展性。

Jenkinsfile使用一种基于Groovy的DSL(领域特定语言)来定义流水线,开发人员可以通过编写Groovy代码来描述流水线的结构和逻辑。

简而言之:Jenkinsfile 就是 Groovy脚本。

2. Groovy实现DSL的基础

Groovy是一种基于JVM的动态语言,它可以直接使用Java类和库,也可以通过闭包和元编程等特性来实现DSL。

2.1 方法调用

在Groovy中,通常情况下需要使用括号来调用带有参数的方法。但是,在一些特定的情况下,也可以省略括号来调用方法,并将参数作为闭包的一部分传递。

def greet(String name) {
    println("Hello, $name!")
}
// 使用括号调用方法
greet("Alice")  // 输出: Hello, Alice!
// 省略括号,将参数作为闭包的一部分传递
greet "Bob"    // 输出: Hello, Bob!

2.2 闭包

闭包可以被视为一个可调用的代码块,它可以作为参数传递给方法、赋值给变量,以及作为返回值返回。

  • 定义闭包:可以使用{}大括号来定义一个闭包,并在其中编写代码块。例如:
def closure = { param ->
    println("Hello, $param!")
}
  • 参数传递:闭包可以接受零个或多个参数,并在代码块中使用这些参数。例如:
def printSum = { a, b ->
    println(a + b)
}
  • 调用闭包:可以通过将闭包像函数一样进行调用来执行其中的代码块。例如:
closure("Alice")  // 输出: Hello, Alice!
printSum(3, 5)   // 输出: 8
  • 作为参数传递:闭包可以作为参数传递给其他方法,使得方法具有更高的灵活性和可重用性。例如:
def processData(data, closure) {
// 执行某些逻辑...
    closure(data)
}
processData("Hello", { input ->
    println("Received: $input")
})

2.3 闭包代理

Groovy还提供了闭包代理(Closure Delegate)机制。闭包代理允许在闭包中访问外部对象的成员变量和方法,而无需显式地使用点操作符。

以下是一个示例:

class Person {
    String name
    void sayHello() {
        println("Hello, I'm $name")
    }
}
def person = new Person(name: "Alice")
def closure = { sayHello() }  // 使用闭包代理调用Person对象的sayHello方法
closure.delegate = person
closure()  // 输出: Hello, I'm Alice

在上面的例子中,我们定义了一个名为closure的闭包,其中调用了外部的Person对象的sayHello()方法。
通过将闭包的delegate属性设置为person对象,我们实现了在闭包中调用person.sayHello()的效果。

3. 从零实现DSL&Jenkinsfile

3.1 使用DSL编写流水线

实现的流水线如下:

jenkinsfile.groovy

import static Dsl.pipeline
pipeline {
    agent any
    environment {
        SOME_NUMBER = 123
        SOME_STRING = "foobar"
    }
    stages {
        stage("Build") {
            steps { env ->
                sh "ls -la"
                sh(script: 'date +%Y-%m-%d', returnStdout: false)
                echo "Groovy rocks!"
                echo "env.SOME_STRING = ${env.SOME_STRING}"
            }
        }
        stage("Test") {
            steps {
                sh """ 
                    echo "Testing..." 
                    """
            }
        }
    }
}

3.2 DSL的具体实现

DSL实现代码如下:

Dsl.groovy

import groovy.transform.NamedParam
import groovy.transform.NamedParams
import groovy.transform.stc.ClosureParams
import groovy.transform.stc.SimpleType
import java.util.concurrent.ConcurrentHashMap
import java.util.concurrent.ConcurrentMap
import static groovy.lang.Closure.DELEGATE_FIRST
import static groovy.lang.Closure.DELEGATE_ONLY
class Dsl {
    static void pipeline(@DelegatesTo(value = PipelineDsl, strategy = DELEGATE_ONLY) final Closure closure) {
        final PipelineDsl dsl = new PipelineDsl()
        closure.delegate = dsl
        closure.resolveStrategy = DELEGATE_ONLY
        closure.call()
    }
}
class PipelineDsl {
    // 定义一个占位符常量
    final Placeholder any = Placeholder.ANY
    // 使用 ConcurrentHashMap 创建环境变量的并发映射
    static final ConcurrentMap<String, String> env = [:] as ConcurrentHashMap
    // 定义 agent 方法
    void agent(final Placeholder any) {
        println "Running pipeline using any available agent..."
    }
    // 定义 environment 方法
    void environment(@DelegatesTo(value = Map, strategy = DELEGATE_FIRST) final Closure closure) {
        // 将闭包委托给 env 并执行闭包
        env.with(closure)
    }
    // 定义 stages 方法
    void stages(@DelegatesTo(value = StagesDsl, strategy = DELEGATE_ONLY) final Closure closure) {
        final StagesDsl dsl = new StagesDsl()
        closure.delegate = dsl
        closure.resolveStrategy = DELEGATE_ONLY
        closure.call()
        // 遍历 stages 列表并依次运行每个 stage
        dsl.stages.each { stage ->
            stage.run()
        }
    }
    // 定义占位符枚举类
    enum Placeholder {
        ANY
    }
}
class StagesDsl {
    // 定义 stages 列表
    protected final List<Stage> stages = []
    // 定义 stage 方法
    void stage(final String name, @DelegatesTo(value = StageDsl, strategy = DELEGATE_ONLY) final Closure closure) {
        // 将 stage 添加到 stages 列表中
        stages << new Stage(name, closure)
    }
}
class Stage {
    final String name
    final Closure closure
    // 定义 Stage 类的构造函数
    Stage(String name, Closure closure) {
        this.name = name
        this.closure = closure
    }
    // 运行 stage 的方法
    void run() {
        println "==> Running '${name}' stage..."
        final StageDsl dsl = new StageDsl()
        closure.delegate = dsl
        closure.resolveStrategy = DELEGATE_ONLY
        closure.call()
    }
}
class StageDsl {
    // 定义 steps 方法
    void steps(
            @DelegatesTo(value = Steps, strategy = DELEGATE_ONLY)
            @ClosureParams(value = SimpleType, options = ["java.util.Map"]) final Closure closure) {
        final Steps steps = new Steps()
        closure.delegate = steps
        closure.resolveStrategy = DELEGATE_ONLY
        closure.call(PipelineDsl.env)
    }
}
class Steps {
    // 定义 sh 方法
    void sh(final String script) {
            sh(script: script, returnStdout: false)
    }
    // 定义重载的 sh 方法
    Object sh(@NamedParams([
            @NamedParam(value = "script", type = String, required = true),
            @NamedParam(value = "returnStdout", type = Boolean)
    ]) final Map param) {
        // 执行 shell 脚本,并等待执行完成
        final Process p = param.script.toString().execute()
        p.waitFor()
        println "+ ${param.script}"
        if (p.exitValue() == 0) {
            if (param.returnStdout) {
                return p.text
            }
            println p.text
        } else {
            println p.err.text
        }
    }
    // 定义 echo 方法
    void echo(final String message) {
        println "[ECHO] ${message}"
    }
}

该DSL提供了以下功能:

  • pipeline 方法用于定义整个流水线。它接受一个闭包作为参数,其中可以定义运行流水线所需的各种配置。
  • agent 方法表示使用任意可用的代理运行流水线。
  • environment 方法用于配置环境变量。它接受一个闭包作为参数,其中可以设置环境变量的键值对。
  • stages 方法用于定义流水线的阶段。它接受一个闭包作为参数,其中可以定义流水线的各个阶段。
  • stage 方法用于定义单个阶段。它接受一个阶段名称和一个闭包作为参数,并将阶段添加到流水线中。
  • steps 方法用于定义阶段的步骤。它接受一个闭包作为参数,并将步骤委托给内部的 Steps 类处理。
  • sh 方法用于执行 shell 脚本。它可以接受一个字符串参数表示脚本,或者一个带有 script 和 returnStdout 键的映射参数。如果脚本执行成功,则会打印脚本的输出;否则,会打印错误信息。
  • echo 方法用于打印出一个带有前缀 [ECHO] 的消息。

通过组合这些方法,可以使用简洁且易读的代码来定义流水线配置,并执行其中的步骤和操作。

3.3 执行流水线

jenkinsfile.groovy可以直接通过 groovy jenkinsfile.groovy 命令执行;

执行结果如下:

$ groovy jenkinsfile.groovy 
Running pipeline using any available agent...
==> Running 'Build' stage...
+ ls -la
razem 32
drwxrwxr-x   5 wololock wololock 4096 04-07 18:20 .
drwxrwxr-x. 45 wololock wololock 4096 04-04 12:47 ..
drwxrwxr-x   3 wololock wololock 4096 04-04 12:48 com
drwxrwxr-x   7 wololock wololock 4096 04-07 18:20 .git
-rw-rw-r--   1 wololock wololock   29 04-07 18:19 .gitignore
drwxrwxr-x   2 wololock wololock 4096 04-07 18:19 .idea
-rw-rw-r--   1 wololock wololock 1016 04-04 13:23 jenkinsfile.groovy
-rw-rw-r--   1 wololock wololock   23 04-07 18:20 README.md
+ date +%Y-%m-%d
2020-04-07
[ECHO] Groovy rocks!
[ECHO] env.SOME_STRING = foobar
==> Running 'Test' stage...
+ mvn -version
Apache Maven 3.5.4 (1edded0938998edf8bf061f1ceb3cfdeccf443fe; 2018-06-17T20:33:14+02:00)
Maven home: /home/wololock/.sdkman/candidates/maven/current
Java version: 1.8.0_232, vendor: Oracle Corporation, runtime: /home/wololock/.sdkman/candidates/java/8.0.232-open/jre
Default locale: pl_PL, platform encoding: UTF-8
OS name: "linux", version: "5.5.10-100.fc30.x86_64", arch: "amd64", family: "unix"

3.4 流水线调用流程分析

// 静态导入列pipline方法
import static Dsl.pipeline
// 调用pipeline方法, 传入一个闭包; 方法调用可以省略() ; pipline {...} 等同于 pipeline({ ... })
pipeline { // pipeline的参数是一个闭包,该闭包被委托给PipelineDsl类处理,所以在闭包内可以直接调用PipelineDsl内部的方法
    // 调用PipelineDsl#agent(any)
    agent any
    // 调用PipelineDsl#environment(closure)
    environment {
        SOME_NUMBER = 123
        SOME_STRING = "foobar"
    }
    // 调用PipelineDsl#stages(closure)
    stages { // stages的参数是一个闭包,该闭包被委托给StagesDsl类处理,所以可以直接调用StagesDsl内部的方法
        // 调用StagesDsl#stage(name, closure)
        stage("Build") { // stage的参数是一个闭包,该闭包被委托给StageDsl类处理,所以可以直接调用StageDsl内部的方法
            // 调用StageDsl#steps(closure)
            steps { env ->   // steps的参数是一个闭包,该闭包被委托给Steps类处理,所以可以直接调用Steps内部的方法
                // 调用Steps#sh(script)
                sh "ls -la"
                // 调用Steps#sh(script, returnStdout)
                sh(script: 'date +%Y-%m-%d', returnStdout: false)
                // 调用Steps#echo(message)
                echo "Groovy rocks!"
                // 调用Steps#echo(message)
                echo "env.SOME_STRING = ${env.SOME_STRING}"
            }
        }
        // 省略... 
        stage("Test") {
            steps {
                sh """ 
                    echo "Testing..." 
                    """
            }
        }
    }
}

参考资料:

Groovy DSL Quickstart:

https://github.com/wololock/groovy-dsl-quickstart

以上就是Jenkins Pipline实现及原理示例解析的详细内容,更多关于Jenkins Pipline实现的资料请关注脚本之家其它相关文章!

相关文章

  • Java 实战范例之进销存管理系统的实现

    Java 实战范例之进销存管理系统的实现

    读万卷书不如行万里路,只学书上的理论是远远不够的,只有在实战中才能获得能力的提升,本篇文章手把手带你用java+vue+Springboot+ssm+mysql+maven+redis实现一个前后端分离的进销存管理系统,大家可以在过程中查缺补漏,提升水平
    2021-11-11
  • Eclipse+Java+Swing+Mysql实现电影购票系统(详细代码)

    Eclipse+Java+Swing+Mysql实现电影购票系统(详细代码)

    这篇文章主要介绍了Eclipse+Java+Swing+Mysql实现电影购票系统并附详细的代码详解,需要的小伙伴可以参考一下
    2022-01-01
  • RocketMQMessageListener注解对rocketmq消息的消费实现机制

    RocketMQMessageListener注解对rocketmq消息的消费实现机制

    这篇文章主要为大家介绍了RocketMQMessageListener注解对rocketmq消息的消费实现机制源码解读,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-10-10
  • Windows下安装ElasticSearch的方法(图文)

    Windows下安装ElasticSearch的方法(图文)

    这篇文章主要介绍了Windows下安装ElasticSearch的方法(图文),小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-01-01
  • Java的特点和优点(动力节点整理)

    Java的特点和优点(动力节点整理)

    由于Java语言的设计者们十分熟悉C++语言,所以在设计时很好地借鉴了C++语言。可以说,Java语言是一种比C++语言“还面向对象”的一种编程语言,下面通过本文说下java的特点和优点
    2017-03-03
  • Java关键字this与super详解用法

    Java关键字this与super详解用法

    这篇文章主要介绍了Java关键字this与super的用法,this与super是类实例化时通往Object类通道的打通者;this和super在程序中由于其经常被隐式的使用而被我们忽略,但是理解其作用和使用规范肯定是必须的。接下来将详述this与super各自的的作用,需要的朋友可以参考一下
    2022-04-04
  • Java使用poi-tl1.9.1生成Word文档的技巧分享

    Java使用poi-tl1.9.1生成Word文档的技巧分享

    本文将简单介绍poi-tl的相关知识,通过一个实际的案例实践,充分介绍如何利用poi-tl进行目标文档的生成,同时分享几个不同的office版本如何进行图表生成的解决方案,需要的朋友可以参考下
    2023-09-09
  • 使用WebSocket实现即时通讯(一个群聊的聊天室)

    使用WebSocket实现即时通讯(一个群聊的聊天室)

    这篇文章主要为大家详细介绍了使用WebSocket实现即使通讯,实现一个群聊的聊天室,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-03-03
  • Java代码实现Map和Object互转及Map和Json互转

    Java代码实现Map和Object互转及Map和Json互转

    这篇文章主要介绍了Java代码实现map和Object互转及Map和json互转的相关资料,需要的朋友可以参考下
    2016-05-05
  • springmvc常用注解标签详解

    springmvc常用注解标签详解

    本篇文章主要介绍了springmvc常用注解标签详解,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-07-07

最新评论