Jenkins Pipeline

  • 介绍

本文介绍如何在Jenkins中使用pipeline插件。

本文的Jenkins是基于docker安装的,如果您对这部分感兴趣,请参考《Docker安装应用》。

Domain Specific Language(DSL)

  • 什么是Pipeline

Jenkins Pipeline是一套插件,支持实现和持续集成作为流水线应用到Jenkins。Pipeline提供了一套可扩展的工具。

  • 为什么要用Pipeline

根本上来说,Jenkins是一个支持很多自动化模式的引擎。Pipeline增加了一套强大的工具到Jenkins中,支持用户从见的持续集成到全面的持续集成。通过模块化一些列相关的任务,用户可以利用很多Pipeline的特性。

代码:Pipelines通过代码来实现,并通常可以由版本控制系统(svn、git等)来管理。

可暂停:Pipelines可以暂停(停止),并且可以在运行之前接收人工输入或者等待同意。

  • Pipeline表达式

Step

是一个单一任务,告诉Jenkins该做什么。例如,在step中执行shell命令make。当一个插件扩展了Pipeline DSl,就意味着可以使用新的step。

Node

大多数工作是在一个或者多个节点(node)中完成的。

  • 语法

Jenkins的流水线(pipeline)采用groovy语法来编写。逻辑判断、循环、异常等功能都是具备的,另外,熟悉groovy的人就明白这和Java的写法有一定的相似。

下面我介绍一些流水线的步骤(或者函数),首先介绍的是在插件workflow-basic-steps-plugin中的。我们从插件的名称上也能看到,这些流水线步骤大多是基础、简单的。首先,给出我研究时的版本信息:

<pre class=”lang:default decode:true “><groupId>org.jenkins-ci.plugins.workflow</groupId>
<artifactId>workflow-basic-steps</artifactId>
<version>2.7-SNAPSHOT</version></pre>

以便各位依据本文可以进一步学习Jenkins流水线插件的源码。

  • 环境变量

<pre class=”lang:default decode:true “>node {
echo env.JENKINS_HOME
sh ‘echo $JENKINS_HOME’

echo env.JOB_NAME
echo env.NODE_NAME
echo env.NODE_LABELS
echo env.WORKSPACE
echo env.JENKINS_URL
echo env.BUILD_URL

env.SUREN_VER = '12'
echo env.SUREN_VER

}</pre>

上面的示例中,给出了如何使用内置的环境变量和自定义环境变量的做法

  • 工具

<pre class=”lang:default decode:true”>node() {
tool name: ‘JDK8_Linux’, type: ‘jdk’
tool name: ‘maven339_linux_dir’, type: ‘maven’
echo ‘hello’
}</pre>

上面的pipeline指定要工具jdk和maven的名称(在Global Tool Configuration中配置)。

对应的实现类为ToolStep,该类被final关键字所修饰,因此是不能做扩展的了。

  • 属性

<pre class=”lang:default decode:true “>node {
echo ‘hello’
}

properties([
buildDiscarder(
logRotator(
artifactDaysToKeepStr: ”,
artifactNumToKeepStr: ”,
daysToKeepStr: ‘5’,
numToKeepStr: ’10’
)
),
pipelineTriggers([
cron(‘H 3,12,17 * * *’)
])
])</pre>

  • 环境变量

<pre class=”lang:default decode:true crayon-selected”>node() {
env.JDK_HOME = “${tool ‘8u131’}”
env.PATH=”${env.JDK_HOME}/bin:${env.PATH}”

echo env.JDK_HOME
echo env.PATH
sh 'java -version'

}

node(‘bimpm_deploytodev’) {
def pass_bin = ‘/opt/pass/bin’
env.PASS_BIN = pass_bin

stage('Clean') {
    sh 'rm -rfv $PASS_BIN'
}

}</pre>

  • 拷贝成品

<pre class=”lang:default decode:true”>node {
stage(‘Copy’) {
step([$class: ‘CopyArtifact’, fingerprintArtifacts: true, flatten: true, projectName: ‘BIM_PMJF/BIM-PMJF-BUILD/BIM_PMJF_DISCOVERY’, selector: [$class: ‘StatusBuildSelector’, stable: false], target: ‘/opt/pass/bin’])
}
}</pre>

实现类为ArtifactArchiverStep

  • 循环

<pre class=”lang:default decode:true “>node(‘suren’) {
def dev_path = ‘/opt/suren/bin’
def services = [
[
‘name’: ‘admin’,
‘project’: ‘admin’,
‘port’: ‘7002’,
‘jarName’: ‘admin’
]
];

stage('Copy Artifact') {
    for(service in services){
        step([$class: 'CopyArtifact', fingerprintArtifacts: true, flatten: true,
            projectName: service.project,
            selector: [$class: 'StatusBuildSelector', stable: false],
            target: dev_path + '/' + service.name
        ])
    }
}

stage('Stop Service') {
    for(service in services){
       sh 'fuser -n tcp -k ' + service.port + ' > redirection &'
    }
}

stage('Start Service') {
    for(service in services){
        sh 'cd ' + pass_bin + '/' + service.name + ' && nohup nice java -server -Xms128m -Xmx384m \
            -jar ' + service.jarName + '.jar \
            --server.port=' + service.port + ' $> initServer.log 2>&1 &'
    }
}

}</pre>

上面的例子,展示了如何在jenkins pipeline中调用循环语句,实现批量操作。

  • 参数化构建

<pre class=”lang:default decode:true “>properties([[$class: ‘JobRestrictionProperty’],
parameters([run(description: ”,
filter: ‘ALL’,
name: ‘Name’,
projectName: ‘Project’)]),
pipelineTriggers([])]
)</pre>

  • 并行

<pre class=”lang:default decode:true”>node {
stage(‘Start Service’) {
parallel ‘test’: {
echo ‘test’
}, ‘deply’: {
echo ‘deply’
}
}

parallel 'one' : {
    stage('one') {
        echo 'one'
    }
}, 'two' : {
    stage('two') {
        echo 'two'
    }
}

}

parallel ‘one’: {
node{
stage(‘one’) {
echo ‘one’
}
}
}, ‘two’: {
node {
stage(‘two’) {
echo ‘two’
}
}
}</pre>

Jenkins的流水线同时支持节点(node)、阶段(stage)和步骤(step)之间的并行执行。如果多个节点并发执行的话,并发数量会少于当前可用的执行器(exector)数量。

  • 超时

<pre class=”lang:default decode:true”>node {
stage(‘stage2’) {
timeout(time: 600, unit: ‘SECONDS’) {
sleep 20
echo ‘2’
}
}
}</pre>

遇到可能执行时间会比较长的情况,可以通过超时来约定最长的执行时间。

对应的实现类为TimeoutStep。

下面介绍的函数在插件workflow-durable-task-step-plugin中,版本信息如下:

<pre class=”lang:default decode:true “><groupId>org.jenkins-ci.plugins.workflow</groupId>
<artifactId>workflow-durable-task-step</artifactId>
<version>2.18-SNAPSHOT</version></pre>

  • 工作空间

当你希望在一个流水线中,对多个工程(例如git工程)做构建以及部署等操作,如果不切换工作空间的话就会发生代码错乱的问题。你可以参考下面的示例代码来解决这个问题:

<pre class=”lang:default decode:true crayon-selected”>node{
stage(‘suren’){
ws(‘suren-a-work’) {
pwd
}

    ws('suren-b-work') {
        pwd
    }
}

}</pre>

实现类为WorkspaceStep,使用final修饰,无法扩展。

  • 执行节点

Jenkins里可能会配置很多节点(node),而不一定所有的节点都满足你的构建环境要求,这时候就需要来指定节点了:

<pre class=”lang:default decode:true “>node(‘local’) {
echo ‘hello’
}

properties([
buildDiscarder(
logRotator(
artifactDaysToKeepStr: ”,
artifactNumToKeepStr: ”,
daysToKeepStr: ‘5’,
numToKeepStr: ’10’
)
),
pipelineTriggers([
cron(‘H 3,12,17 * * *’)
])
])</pre>

上面的pipeline指定了运行节点的label为local。

实现类为ExecutorStep,使用final修饰,无法扩展。

  • 异常捕获

<pre class=”lang:default decode:true”>node{
stage(‘suren’){
try{
trigger
}catch(error){
echo error.getMessage()
}
}
}</pre>

这里调用了一个不存在的流水线函数,然后使用catch来捕获并打印错误信息。

  • 远程调试

安装环境:

sudo apt-get install -y npm

jenkins-pipeline --file test.groovy --url http://localhost:8080/jenkins/job/MyJob --credentials admin:123456

  • 参考

http://cloud.spring.io/spring-cloud-pipelines/

本文为原创,如果您当前访问的域名不是surenpi.com,请访问“素人派”。

    原文作者:素人派
    原文地址: https://www.jianshu.com/p/355a1e683835
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞