如何使用GitHub Org插件从jenkins管道(jenkinsfile)触发另一个工作?


142

如何从内部触发另一个作业的生成Jenkinsfile

我假设这项工作是同一个github组织下的另一个存储库,该存储库已经有自己的Jenkins文件。

我也只想在分支名称为master时执行此操作,因为触发任何本地分支的下游构建都没有意义。

更新:

stage 'test-downstream'
node {
     def job = build job: 'some-downtream-job-name'
}

不过,执行时我还是报错

找不到名为some-downtream-job-name的参数化作业

我确定这项工作存在于jenkins中,并且与当前工作位于同一组织文件夹下。这是另一项有自己的工作Jenkinsfile

请注意,此问题特定于GitHub Organization Plugin,该插件可自动为GitHub Organization中的每个存储库和分支创建和维护作业。

Answers:


131

首先,将build步骤包装进去很浪费执行器插槽node。您的上游执行者将无故闲着。

其次,在多分支项目中,可以使用环境变量BRANCH_NAME使逻辑在当前分支上成为条件。

第三,该job参数采用绝对或相对的作业名称。如果您提供的名称没有任何路径限制,则将引用同一文件夹中的另一个作业,对于多分支项目,这将意味着同一存储库的另一个分支。

因此,您打算写的可能是

if (env.BRANCH_NAME == 'master') {
    build '../other-repo/master'
}

2
谢谢!如果通过任何更改您还知道如何在不等待其完成的情况下触发此构建,那将是双重的:)
sorin

48
检查代码段生成器build job: '../other-repo/master', wait: false
Jesse Glick

3
有什么方法可以使用动态分支名称来调用构建步骤?喜欢的东西build job: '../other-repo/$BRANCH_NAME'哪里$BRANCH_NAME是詹金斯环境变量有关运行多枝项目的分支?
msteppe91 '18 -10-2

2
如果${BRANCH_NAME}可以用作环境变量,则可以使用简单的字符串替换。只是一定要切换到"'为引用您的字符串。例如build job: "../other-repo/${BRANCH_NAME}"
Cinderhaze


123

除了上述答案外:我想通过传递给第二个管道的简单参数开始工作,并在https://dzone.com/refcardz/continuous-delivery-with-jenkins-workflow上找到答案。

所以我用了:

stage ('Starting ART job') {
    build job: 'RunArtInTest', parameters: [[$class: 'StringParameterValue', name: 'systemname', value: systemname]]
}

11
构建作业必须嵌入到一个步骤中(从版本0.5开始)
rhoerbe

5
是否build返回了由该命令调用的Jenkins作业的BUILD_NUMBER ?如何通过以下步骤之一访问BUILD_NUMBER?有人知道该命令的记录位置吗?
user909481 '09 / 09/13

4
这是build job: 'freestyle', parameters: [ string(name: 'param1', value:'test_param'), string(name:'dummy', value: "${index}")]时下,从jenkins.io/doc/pipeline/examples/#jobs-in-parallel
BartBiczBoży

但是如何使用在第二次作业中传递的这些参数
温柔的

2
有趣的是, build job: 'RunArtInTest', parameters: [[$class: 'StringParameterValue', name: 'systemname', value: systemname]] 这对我没有用,但是: build job: 'RunArtInTest', parameters: [string(name: 'systemname', value: "${VALUE}")] 有效
Alberto C

24

build管道中的命令在那里触发jenkins中的其他作业。

github上的例子

这项工作必须存在于詹金斯并且可以参数化。至于分支,我想你可以从git中读取它


3
我尝试添加,build job: 'jobname但是出现此错误No parameterized job named jobname found,我可以向您保证组织文件夹中存在具有该名称的同一级别的作业。
索林

1
是的,有一个作业,但是该作业未参数化。我正在尝试了解如何参数化由GitHub组织插件创建的作业
yiwen

6
职位名称格式为:build job: "${ORGANISATION_NAME}/${REPO_NAME}/master"
Sahil Ahuja

2
@SahilAhuja这完全是任意的,并且基于您的Jenkins布局,如果要使用绝对路径,则需要以。开头/。相对路径很好;索林(Sorin)的问题可能是该作业调用build是一个多分支作业,这意味着一条路径jobname会尝试建立jobname同一作业的分支。它需要../jobname/branchname改为
Michael Mrozek '18

这很好用,但是,如果指定的分支不存在怎么办?
JaimeAlcántaraArnela

17

您可以使用Jenkins Pipeline中build job步骤(最低Jenkins要求:2.130)。

这是该build步骤的完整API :https : //jenkins.io/doc/pipeline/steps/pipeline-build-step/

使用方法build

  • job:要构建的下游作业的名称。可能是另一项Pipeline工作,但更常见的是自由泳或其他项目。
    • 如果作业与此上游Pipeline作业位于同一文件夹中,请使用简单名称;否则,请使用简单名称
    • 您可以改用相对路径,例如../sister-folder/downstream
    • 或者你可以使用绝对路径,/top-level-folder/nested-folder/downstream

使用分支作为参数触发另一个作业

在我公司,我们的许多分支都包含“ /”。您必须将“ /”的所有实例替换为“%2F”(显示在作业的URL中)。

在此示例中,我们使用相对路径

    stage('Trigger Branch Build') {
        steps {
            script {
                    echo "Triggering job for branch ${env.BRANCH_NAME}"
                    BRANCH_TO_TAG=env.BRANCH_NAME.replace("/","%2F")
                    build job: "../my-relative-job/${BRANCH_TO_TAG}", wait: false
            }
        }
    }

使用内部版本号作为参数触发另一个作业

build job: 'your-job-name', 
    parameters: [
        string(name: 'passed_build_number_param', value: String.valueOf(BUILD_NUMBER)),
        string(name: 'complex_param', value: 'prefix-' + String.valueOf(BUILD_NUMBER))
    ]

并行触发许多作业

资料来源:https : //jenkins.io/blog/2017/01/19/converting-conditional-to-pipeline/

有关并行的更多信息,请访问:https//jenkins.io/doc/book/pipeline/syntax/#parallel

    stage ('Trigger Builds In Parallel') {
        steps {
            // Freestyle build trigger calls a list of jobs
            // Pipeline build() step only calls one job
            // To run all three jobs in parallel, we use "parallel" step
            // https://jenkins.io/doc/pipeline/examples/#jobs-in-parallel
            parallel (
                linux: {
                    build job: 'full-build-linux', parameters: [string(name: 'GIT_BRANCH_NAME', value: env.BRANCH_NAME)]
                },
                mac: {
                    build job: 'full-build-mac', parameters: [string(name: 'GIT_BRANCH_NAME', value: env.BRANCH_NAME)]
                },
                windows: {
                    build job: 'full-build-windows', parameters: [string(name: 'GIT_BRANCH_NAME', value: env.BRANCH_NAME)]
                },
                failFast: false)
        }
    }

或者:

    stage('Build A and B') {
            failFast true
            parallel {
                stage('Build A') {
                    steps {
                            build job: "/project/A/${env.BRANCH}", wait: true
                    }
                }
                stage('Build B') {
                    steps {
                            build job: "/project/B/${env.BRANCH}", wait: true
                    }
                }
            }
    }

3

为该任务使用构建作业插件,以便从jenkins文件触发其他作业。您可以在执行中添加各种逻辑,例如并行,节点和代理选项以及触发外部作业的步骤。为此,我给出了一些易于阅读的菜谱示例。

1.使用条件示例从jenkins文件触发外部作业的示例:

if (env.BRANCH_NAME == 'master') {
  build job:'exactJobName' , parameters:[
    string(name: 'keyNameOfParam1',value: 'valueOfParam1')
    booleanParam(name: 'keyNameOfParam2',value:'valueOfParam2')
 ]
}

2.example使用条件示例从jenkins文件触发多个作业:

 def jobs =[
    'job1Title'{
    if (env.BRANCH_NAME == 'master') {
      build job:'exactJobName' , parameters:[
        string(name: 'keyNameOfParam1',value: 'valueNameOfParam1')
        booleanParam(name: 'keyNameOfParam2',value:'valueNameOfParam2')
     ]
    }
},
    'job2Title'{
    if (env.GIT_COMMIT == 'someCommitHashToPerformAdditionalTest') {
      build job:'exactJobName' , parameters:[
        string(name: 'keyNameOfParam3',value: 'valueOfParam3')
        booleanParam(name: 'keyNameOfParam4',value:'valueNameOfParam4')
        booleanParam(name: 'keyNameOfParam5',value:'valueNameOfParam5')
     ]
    }
}

但是,如何在第二个作业中接收和使用参数
温柔的

2
@温和。您可以访问传递paramater作为params.systemname
潘卡欣德
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.