7. Jenkins 其他功能

    本篇主要介绍日常使用Jenkins过程中一些比较实用的功能。

7.1 Jenkins内部调用另一个job

    假设在一个Jenkins中有两个彼此独立的任务，但随着迭代不断更新，两个彼此独立的任务需要相互调用。这时候我们可以在一个任务中，添加另一个任务的步骤。除这种方法，还有没有其他的办法呢？

    既然在Jenkins存在参数化的pipeline，则应该是可以支持在一个pipeline中调用另一个pipeline。而要实现这个功能，在pipeline中可以使用build步骤来实现。看起来是不是与upsteam非常相似，主要区别如下所示：

• build 步骤是上游使用，而upstream是下游使用
• build 可以带参数，而upsteam属于被动触发且不能带参数

    build 使用用法示例如下所示：

steps{
   build(
     job:"jobName",
     parameters:[
        paramsType(name:"name",value:"value")
     ],
     propagate:true,
     quietPeriod:3,
     wait:true
   )
}

    build 步骤的两个基本参数如下所示：

• job: 必填参数,目标任务的名称
• parameters: 可选参数，目标任务的传入参数列表，使用方法与参数化命令parameters类似。
• propagate：可选参数，布尔类型。若值为true，则只有当下游pipeline的运行结果状态为SUCCESS时，上游pipeline才算成功，若值为false，则忽略下游pipeline的运行结果状态，上游pipeline都忽略。默认为true
• quietPeriod：可选参数，整型。触发下游pipeline后，下游pipeline等待多久执行。如果不设置，则等待时长由下游pipeline确定，单位为秒
• wait：可选参数，布尔类型，是否等待下游pipeline运行完成。默认为true

choice类型的参数没有对应的传参方法，使用string传参方法代替

    假设现在有两个job，分别为SurpassA和SurpassB，上游为SurpassA，下游为SurpassB

• SurpassB的任务pipeline脚本如下所示：

pipeline{
    agent any
    options{
        timestamps()
    }
    parameters{
        string(
          name:"stringDemo",
          defaultValue:"job string SurpassB",
          description:"job SurpassB string demo"
        )
        text(
          name:"textDemo",
          defaultValue:"job text SurpassA\njob text SurpassB\njob text SurpassC",
          description:"job SurpassB text demo"
        )
        booleanParam(
          name:"booleanDemo",
          defaultValue:true,
          description:"job SurpassB boolean demo"
        )
        choice(
          name:"choiceDemo",
          choices:["SurpassA","SurpassB","SurpassC"],
          description:"job SurpassB choice demo"
        )
        password(
          name:"passwdDemo",
          defaultValue:"job passwd SurpassB",
          description:"job SurpassB password demo"
        )
    }

    stages{
        stage("job SurpassB demo"){
            steps{
                echo "job SurpassB demo"
            }
        }
    }
}

• SurpassA的任务pipeline脚本如下所示：

pipeline{
    agent any
    options{
        timestamps()
    }

    stages{
        stage("call inner jobs demo"){
            steps{
                echo "call inner job SurpassB"
                build(
                    job:"39-SurpassB",
                    parameters:[
                        string(name:"stringDemo",value:"input text by SurpassA"),
                        text(name:"textDemo",value:"input text by SurpassB"),
                        booleanParam(name:"booleanDemo",value:false),
                        string(name:"choiceDemo",value:"SurpassB"),
                        password(name:"passwdDemo",value:"Surpass")
                    ]
                )
            }
        }
    }
}

    最终运行结果如下所示：

0701 调用内部job.png

7.2 Jenkins调用外部Jenkins

    前面演示的在同一个Jenkins，内部相互调用不同任务的pipeline，那如果是两个不同服务节点的Jenkins有没有相互调用呢？答案是可以的。

    通过远程Jekins调用本地Jenkins，演示的环境如下所示：

Jenkins Server	描述信息
192.168.188.133	本地Jenkins
192.168.188.132	远程Jenkins

    操作步骤如下所示：

• 1.在本地Jenkins开启触发远程构建，并设置相应的Token，如下所示：

0702 开启远程构建.png

• 2.在本地Jenkins新建一个用户，并以该用户进行登录，查看并复制对应的API Token信息，如下所示：

0703 新建用户并复制API Token.png

• 3.通过接口工具(如Postman)发送HTTP请求，检验是否能成功调用

0704 远程构建接口演示.png

    运行结果如下所示：

0705 远程调用Jenkins远程调用运行日志.png

• 4.在远程pipeline中添加以下步骤即可实现远程调用

pipeline{
    agent any
    options{
        timestamps()
    }

    stages{
        stage("remote call pipeline demo"){
            steps{
                script{
                    def url="Surpass:110313acfb17c8b2058f9816d5b6062455@192.168.188.133:9090/job/39-SurpassB/buildWithParameters?token=surpass-local&stringDemo=SurpassRemote&textDemo=SurpassRemote&booleanDemo=true&choiceDemo=SurpassB&passwdDemo=SurpassRemote"
                    sh(
                        script:"curl -X POST \'${url}\'",
                        returnStatus:true
                    )
                }
            }
        }
    }
}

    运行结果如下所示：

0706 远程Jenkins调用本地Jenkins.png

7.3 Jenkins 备份

    Jenkins 的所有数据都是存放在文件中。因此Jenkins备份也就是备份JENKINS_HOME目录。其目录结构大致如下所示：

• config.xml: Jenkins系统配置文件
• *.xml: 部分插件配置文件
• plugins：插件安装路径
• jobs: job存放路径

    其中jobs的文件目录结构如下所示：

jobName: 以Jenkins 项目名称做为文件夹名称
   - config.xml: 该项目对应的配置文件，里面存储有相应的pipeline
   - nextBuildNumber：存放下一次构建的构建号，为文本文件
   - builds：每次构建内容

• workspace： 工作空间目录

    并不是所有内容都需要备份，一般来讲，只需要备份jobs和plugins目录即可。