Jenkins实践指南-10-Jenkins 插件

6. Jenkins 插件

    [作者:Surpassme]Jenkins之所以这么流行,不仅在于本身功能非常齐全,也在于本身插件非常丰富,以下主要介绍平时经常使用的到插件。

6.1 插件安装

    [作者:Surpassme]依次点击Manage Jenkins -> Manage Plugins -> Available,搜索插件并安装即可,示意图如下所示:

6.2 常用插件

6.2.1 Git Parameter

    [作者:Surpassme]该插件允许在构建时,选择指定的git分支、标签等,官网地址 :https://plugins.jenkins.io/git-parameter/。pipeline 示例录下所示:

pipeline {
  agent any
  environment{
     CODE_SUB_DIR_PATH="surpass"
	 CODE_GitURL="https://gitlab.surpass.com/surpass/demo.git"
  }
  parameters {
     gitParameter(
        name:"CODE_TAG_BRANCH_NAME",
        type:"PT_BRANCH_TAG",
        branchFilter: "origin/(.*)",
        defaultValue: "test",
        selectedValue:"DEFAULT",
        sortMode:"DESCENDING_SMART",
        useRepository:"${env.CODE_GitURL}",
        description: "请选择branch或tag"
        )
  }
  stages {
    stage("拉取代码"){
		   steps{
		    checkout([
				$class:"GitSCM",
				branches:[[name:"${params.CODE_TAG_BRANCH_NAME}"]],
				doGenerateSubmoduleConfigurations: false,
				extensions: [[
				   $class:"RelativeTargetDirectory",
				   relativeTargetDir:"${env.CODE_SUB_DIR_PATH}"
				]],
				gitTool: "Default",
				submoduleCfg: [],
				userRemoteConfigs:[[
				    credentialsId:"32eddb12-cd66-444b-859d-ccb61c3864d1",
				    url:"${env.CODE_GitURL}"
				]]
			])
		 }
	}
    }
}

    [作者:Surpassme]其主要参数解释如下所示:

  • type:主要支持PT_TAGPT_BRANCHPT_BRANCH_TAGPT_REVISIONPT_PULL_REQUEST
  • sortMode:主要支持NONEASCENDING_SMARTDESCENDING_SMARTASCENDINGDESCENDING
  • useRepository: 默认使用的gitlab仓库地址

6.2.2 build user vars

    [作者:Surpassme]通过设置环境变量来获取启动任务的用户名,官网地址:https://plugins.jenkins.io/build-user-vars-plugin/,一般常用于多用户下的Jenkins环境。主要支持的环境变量如下所示:

变量名称 描述信息
BUILD_USER Full name (first name + last name)
BUILD_USER_FIRST_NAME First name
BUILD_USER_LAST_NAME Last name
BUILD_USER_ID Jenkins user ID
BUILD_USER_GROUPS Jenkins user groups
BUILD_USER_EMAIL Email address

    [作者:Surpassme]示例用法如下所示:

pipeline{
    agent any
    stages{
        stage("get build user demo"){
            steps{
                script{
                    wrap([$class: 'BuildUser']) {
			env.BUILD_USER = "${BUILD_USER_ID}"
		   }
                }
            }
        }
        stage("print build  user"){
            steps{
                echo "build user is ${env.BUILD_USER}"
            }
        }
    }
}

6.2.3 Pipeline Utility Steps

    [作者:Surpassme]该插件功能非常多,可以用来比较版本大小、查找文件、读取CSV、JSON、YAML等,其官网地址:https://plugins.jenkins.io/pipeline-utility-steps/,我们以读写YAML为示例,如下所示:

def readYamlFile(filePath,imageName){
    if (fileExists(filePath)){
	   println("Yaml file path is ${filePath}")
	   def data=readYaml(file:filePath)
	   println("YAML文件内容:\n${data}")
	   def testText=data.spec.template.spec.containers[0][0].image
	   data.spec.template.spec.containers[0][0].image=imageName
	   println("修改前的镜像地址:${testText}\n修改后的镜像地址:${imageName}")
           return data
       }
   else{
	println("${filePath} not exists,please check !!!")
   }
}

def writeYamlFile(filePath,content,overwrite=true,charset="UTF-8"){
    if (fileExists(filePath)){
	writeYaml(file:filePath,datas:content,overwrite:overwrite,charset:charset)
	}
   else{
	   println("${filePath} not exists,please check !!!")
	}
}

6.2.4 HTTP Request

    [作者:Surpassme]主要用于发送HTTP请求,比如向企业微信机器人发送消息等,官网地址:https://plugins.jenkins.io/http_request/,HTTP Request支持的参数如下所示:

  • url:字符串类型,请示URL地址
  • acceptType:枚举类型,HTTP请求Header的Accept的值类型,可以支持的参数如下所示:
- NOT_SET
- TEXT_HTML
- TEXT_PLAIN
- APPLICATION_FORM
- APPLICATION_JSON
- APPLICATION_JSON_UTF8 // 若含中文,需要使用这种方式
- APPLICATION_TAR
- APPLICATION_ZIP
- APPLICATION_OCTETSTREAM
  • authentication:字符串类型,使用的是HTTP Basic谁,即用户名+密码这种形式
  • consoleLogResponseBody:布尔类型,是否将请求的响应body打印出来
  • contentType:枚举类型,HTTP请求的Content-Type值类型,同acceptType
  • customHeaders:HttpRequestNameValuePair对象数组,HTTP请求Header部分内容,该对象有3个参数。
name:字符串类型,Header名称
value:字符串类型,Header值
maskValue:布尔类型,是否隐藏Header值。若为true,则打印时使用*代替
  • httpMode:枚举类型,HTTP方法,有GET(默认)、HEAD、POST、PUT、DELETE、OPTIONS、PATCH等
  • httpProxy:字符串类型,HTTP代理地址
  • ignoreSslErrors:布尔类型,是否忽略SSL错误
  • requestBody:字符串类型,请求的body内容
  • timeout:整理,超时时间,单位为秒。默认为0,代表不设置超时时间
  • vaildResponseCodes:字符串类型,代表HTTP请求成功的状态码。其支持3种格式的值
- 单状态值:如200,当收到200状态码,表示HTTP请求成功
- 多状态值:当响应状态码符合多个状态码中的一个时,则代表请求成功,多个状态码之间使用逗号分隔。如200,300
- 范围状态值:格式为"From:To",如200:302,代表收到200~302的响应状态码都算请求成功
  • validResponseContent:字符串类型,假设设置其值为:supass.name,则只有当HTTP返回的内容中包含了supass.name时,才算请求成功。
  • quiet:布尔类型,是否关闭所有的日志打印,默认为false
  • responseHandle:枚举类型,获取HTTP响应内容的方式,其值可以为:
- NONE:不读取响应内容
- LEAVE_OPEN:当执行完请求后,并不会返回响应内容,而是返回一个打开的inputStream,由你自己决定如何读取响应内容,在使用完之后,需要调用inputStream的close方法关闭
- STRING:默认值,将响应内容转换为一个字符串
  • outputFile:字符串类型,请求响应内容的输出路径alue:布尔类型,是否隐藏Header值。若为true,则打印时使用*代替

    示例代码如下所示:

def httpRequestSendMessage(address,method,body){
    def response=httpRequest(url:address,
			acceptType:"APPLICATION_JSON_UTF8",
			contentType:"APPLICATION_JSON_UTF8",
			httpMode:method,
			requestBody:body,
			ignoreSslErrors:true,
			validResponseCodes:"200"
			)
    println("response.status is:${response.status}\nresponse.content:${response.content}")

6.2.5 Allure

    allure是一个轻量级别的多语言测试报告插件,常用于在自动化测试中以WEB形式展示测试报告,官网地址:https://plugins.jenkins.io/allure-jenkins-plugin/,其示例用法如下所示:

post{
  always{
    script{
	   allure([
		 includeProperties : false,
		 jdk:"",
		 properties: [],
		 reportBuildPolicy: "ALWAYS",
		 report: "${env.ALLURE_REPORT_PATH}",
		 results: [[ path: "${env.ALLURE_RESULT_PATH}" ]]
	   ])
	}
  }
}

    [作者:Surpassme]使用注意事项如下所示:

  • report:生成allure最终报告的存储路径,其中默认生成的路径为相对于$WORKSPACE的路径
  • results:生成allure的中间数据,即生成的原始报告数据,支持多个路径中间数据,其中默认生成的路径为相对于$WORKSPACE的路径

6.2.6 Active Choices

    [作者:Surpassme]Active Choices 插件常用于创建动态交互式参数化插件。其官网地址:https://plugins.jenkins.io/uno-choice/,其主要支持的参数类型有:

  • Active Choices Parameter
  • Active Choices Reactive Parameter
  • Active Choices Reactive Reference Parameter

    Active Choices parameters 允许用户为任务参数选择值,参数值如下所示:

  • dynamically generated:动态生成(使用Groovy)
  • dynamically updated based on other UI parameters:基于其他UI参数进行更新
  • multi-valued:多个值
  • rendered with a variety of UI controls, including dynamic HTML:使用多种UI控件渲染,包含动态HTML

6.2.6.1 Active Choices Parameter

  • 1.Behavior

    [作者:Surpassme]Active Choices parameter 使用Groovy脚本动态生成参数列表

  • 2.Rendering

    [作者:Surpassme]Active Choices parameters 可以生成标准列表选择、复选框和单选框
    [作者:Surpassme]可以生成文本框筛选器来筛选选项

图片来自于:https://github.com/jenkinsci/active-choices-plugin/blob/master/docs/images/001.jpg

6.2.6.2 Active Choices Reactive and Reactive Reference Parameters

  • 1.Behavior

    [作者:Surpassme]与Active Choices Parameter类似,可以使用Groovy脚本为构建任务动态生成参数选项,当UI控件值发生变更时,也可以动态级联更新。

  • 2.Rendering Options

    [作者:Surpassme]Active Choices Reactive:可以生成标准列表选择、复选框、单选框和文本框筛选器来筛选选项
    [作者:Surpassme]Active Choices Reactive Reference:可以生成HTML列表、HTML输入框、动态生成HTML等

图片来自于:https://cdn.jsdelivr.net/gh/jenkinsci/active-choices-plugin@master/docs/images/002.gif

6.2.6.3 Behavior and Rendering Summary

    [作者:Surpassme]以下为三种Active Choices parameter的行为和呈现特征对比

图片来自于:https://cdn.jsdelivr.net/gh/jenkinsci/active-choices-plugin@master/docs/images/003.jpg

6.2.6.4 Active Choices Parameter 示例

6.2.6.4.1 Active Choices Parameter 示例

    [作者:Surpassme]以下为在自由风格中的配置,示例如下所示:

    [作者:Surpassme]主要参数解释如下所示:

  • Name 和 Describe

    [作者:Surpassme]与常规Jenkins 参数一致,用于一个参数的名称和描述信息

  • Script

    动态生成参数所使用的脚本代码,脚本返回必须为 java.util.Listjavajava.util.Map

  • Fallback Script

    [作者:Surpassme]主要提供备用选项,在脚本出错时,使用该值

  • Choice Type

    [作者:Surpassme]主要提供四种不同的类型选择单选框复选框列表单选列表多选

  • Enable Filte

    [作者:Surpassme]是否启用筛选搜索

6.2.6.4.2 Active Choices Parameter Rendering示例
  • 示例-1

  • 示例-2

6.2.6.5 pipeline 示例

    [作者:Surpassme]通过自由风格来配置Active Choice非常方便,但迁移起来也非常麻烦的,pipeline示例如下所示:

properties([
  parameters([
    [
      $class: "ChoiceParameter",
      choiceType: "PT_SINGLE_SELECT",
	  description:"请选择一个省份",
	  filterable: true,
	  filterLength: 1,
      name: "Province",
      script: [
         $class: "GroovyScript",
         script:[
		    classpath: [],
            sandbox: true,
            script: "return ['江苏','浙江','安徽']"
		    ],
		 fallbackScript:[
		   classpath: [],
           sandbox: true,
           script: "return['错误']"
		 ]
      ]
    ],
    [
      $class: "CascadeChoiceParameter",
      choiceType: "PT_CHECKBOX",
      name: "City",
      referencedParameters: "Province",
      script: [
         $class: "GroovyScript",
         script:[
		    classpath: [],
            sandbox: true,
            script: '''
			if(Province.equals("江苏")){
			  return ["南京:selected","苏州","无锡","常州"]
			} else if(Province.equals("浙江")){
			  return ["杭州:selected","绍兴","宁波","温州"]
			} else if(Province.equals("安徽")){
			  return ["合肥:selected","芜湖","六安","马鞍山"]
			} else {
			  return ["未知城市"]
			}
			'''
		    ],
		 fallbackScript:[
		   classpath: [],
           sandbox: true,
           script: "return['脚本错误']"
		 ]
      ]
   ]
 ])
])

pipeline{
    agent any
    options{
        timestamps()
    }

    stages{
        stage("active choice demo"){
            steps{
                echo "Province is:${params.Province}"
                echo "City is:${params.City}"
            }
        }
    }
}

    [作者:Surpassme]运行结果如下所示:

注意事项:[作者:Surpassme]sandbox需要配置为true,因Jenkins安全策略限制,若为false,可能配置选项无法显示

    常见的Choice Type 如下所示:

  • PT_SINGLE_SELECT:下拉单选
  • PT_MULTI_SELECT:列表多选
  • PT_CHECKBOX:筛选框
  • PT_RADIO:单选框

    [作者:Surpassme]源码定义如下所示:

/*
* Constants.
*/
// default choice type
public static final String PARAMETER_TYPE_SINGLE_SELECT = "PT_SINGLE_SELECT";
public static final String PARAMETER_TYPE_MULTI_SELECT = "PT_MULTI_SELECT";
public static final String PARAMETER_TYPE_CHECK_BOX = "PT_CHECKBOX";
public static final String PARAMETER_TYPE_RADIO = "PT_RADIO";

// default choice type
public static final String ELEMENT_TYPE_TEXT_BOX = "ET_TEXT_BOX"; 
public static final String ELEMENT_TYPE_ORDERED_LIST = "ET_ORDERED_LIST";
public static final String ELEMENT_TYPE_UNORDERED_LIST = "ET_UNORDERED_LIST";
public static final String ELEMENT_TYPE_FORMATTED_HTML = "ET_FORMATTED_HTML";
public static final String ELEMENT_TYPE_FORMATTED_HIDDEN_HTML = "ET_FORMATTED_HIDDEN_HTML";

源码链接:https://github.com/jenkinsci/active-choices-plugin/blob/master/src/main/java/org/biouno/unochoice/AbstractUnoChoiceParameter.java

6.2.7 邮件通知

    [作者:Surpassme]邮件也是日常Jenkins常用的通知方式,Jenkins默认支持

6.2.7.1 使用Jenkins内置邮件通知功能

    [作者:Surpassme]以QQ邮箱演示,操作步骤如下所示:

在配置邮箱时,需要确认所使用的邮箱已经打开SMTP服务

    1. 设置管理员邮箱,如下所示:

  • 2、配置SMTP服务器信息

  • 3、在pipeline中Post部分加入发送邮件配置
pipeline{
    agent any
    options{
        timestamps()
    }

    stages{
        stage("Test e-mail Demo"){
            steps{
                echo "Test e-mail demo"
            }
        }
    }

    post{
        success{
            mail(
                from: "surpassme@qq.com",
                to:   "surpassme@qq.com",
                body: "This is test Jenkins send e-mail,please don't reply",
                subject: "Test e-mail demo"
                )
        }
    }
}

    主要参数解释如下所示:

  • from: 发件人地址
  • to:收件人地址
  • body:邮件正文
  • subject:邮件主题

6.2.7.2 使用E-mail Extension 插件通知

    [作者:Surpassme]如果觉得Jenkins内置的邮件功能不能满足要求,也可以试试插件E-mail Extension,其官网为:https://plugins.jenkins.io/email-ext/,其主要特色功能:

  • 可以定制收件人列表
  • 可以将日志以附件形式进行发送
  • 可以发送附件

    E-mail Extension使用步骤如下所示:

  • 1、配置SMTP服务器信息,如下所示:

  • 2、在pipeline中Post部分加入发送邮件配置
pipeline{
    agent any
    options{
        timestamps()
    }

    stages{
        stage("Test e-mail Demo"){
            steps{
                echo "Test e-mail demo"
            }
        }
    }

    post{
        success{
            emailext (
                to:   "surpassme@qq.com",
                subject: "Test e-mail demo",
                body: """
                       JobName:${env.JOB_NAME}
                       BuildNumber:${env.BUILD_NUMBER}
                       BuildURL:${env.BUILD_URL}
                       View console log url:${env.BUILD_URL}console
                      """,
                compressLog: true,
                attachLog: true,
                recipientProviders: [developers(), requestor()],
                )
        }
    }
}

    运行结果如下所示:

    [作者:Surpassme]emailext的主要参数解释如下所示:

  • from:可选,为string类型,发件人地址
  • to:可选,为string类型,收件人地址
  • subject:为string类型,邮件主题
  • body:为string类型,邮件正文
  • compressLog:为boolean类型,是否压缩日志
  • attachLog:可选,为boolean类型,是否将构建日志以附件形式发送
  • attachmentsPattern:可选,为string类型,需要发送的附件的路径,支持ANT风格路径表达式
  • recipientProviders:可选,List类型,收件人列表类型

    常用的收件人列表类型如下所示

类型名称 功能解释
developers 此次构建所涉及变更的所有提交者列表
requestor 启动构建任务的人
culprits 引发构建失败的,即最后一次构建成功和最后一次构建失败之间的变更提交者列表

6.2.8 Periodic Backup

    [作者:Surpassme]Jenkins本身并不提供备份功能,而是使用插件来进行备份。这里推荐使用插件Periodic Backup(https://plugins.jenkins.io/periodicbackup/)来实现备份。操作步骤如下所示:

  • 1.Manage Jenkins -> Periodic Backup Manager 如下所示:

  • 2.点击Periodic Backup Manager,进行配置

    [作者:Surpassme]主要参数如下所示:

  • Backup schedule (cron)

    备份的cron表达式,在配置后,可以点击Validate cron syntax进行校验

  • File Management Strategy

    设备备份策略,ConfigOnly仅备份配置文件,FullBackup 全量备份,也可以在Excludes list 使用Ant风格路径表达式,排除不希望进行备份的文件

  • Storage Strategy

    [作者:Surpassme]备份文件的保存格式。

  • Backup Location

    备份文件存放位置。需要对文件夹具有相应的读写权限

  • 3.备份成功后,在Restore页面,可以看到最近的备份结果

  • 4.若需要还原,选中对应的备份文件,点击Restore selected backup即可。

原文地址:https://www.jianshu.com/p/9c6bf5a3a969

本文同步在微信订阅号上发布,如各位小伙伴们喜欢我的文章,也可以关注我的微信订阅号:woaitest,或扫描下面的二维码添加关注:

posted @ 2023-01-06 00:43  Surpassme  阅读(777)  评论(0编辑  收藏  举报