"Build Periodically" with a Multi-branch Pipeline in Jenkins

Question

I'm running Jenkins 2 with the Pipeline plugin. I have setup a Multi-branch Pipeline project where each branch (master, develop, etc.) has a Jenkinsfile in the root. Setting this up was simple. However, I'm at a loss for how to have each branch run periodically (not the branch indexing), even when the code does not change. What do I need to put in my Jenkinsfile to enable periodic builds?

score 113 · Accepted Answer · answered Jul 04 '17 at 09:50

113

If you use a declarative style Pipeline and only want to trigger the build on a specific branch you can do something like this:

String cron_string = BRANCH_NAME == "master" ? "@hourly" : ""

pipeline {
  agent none
  triggers { cron(cron_string) }
  stages {
    // do something
  }
}

Found on Jenkins Jira

answered Jul 04 '17 at 09:50

Julian Veerkamp

1,694
2
16
20

31

This works, but note that committing and pushing the Jenkinsfile is not enough for the trigger to be picked up; the job has to be run once manually afterwards as well. – Cameron Nov 29 '17 at 14:46
1

Can the trigger be inside of a stage block? I.e. stage('Deploy to production') { triggers { cron(MASTER_TRIGGER) } – Learner Feb 14 '18 at 23:54
3

Will this work in a declarative jenkins file or only a scripted jenkins file? – Learner Feb 15 '18 at 00:00
Should work with a declarative Jenkinsfile. The trigger only works inside the options tag iirc. If you want to only deploy the master branch you can put a script{ if (BRANCH_NAME == „Master“) { //deploy}} inside the deploy block. (I’m currently on mobile so the syntax might be wrong) – Julian Veerkamp Feb 17 '18 at 12:53
@Learner "if you use a declarative style Pipeline" – OrangeDog Aug 08 '19 at 13:48
@Cameron you can also add another trigger, such as pollSCM or a webhook. – OrangeDog Aug 08 '19 at 13:48
1

Since oct 2020, new git repos use "main" instead of "master" -> Hopefully this comment will help someone else who copy pasted from this answer didn't get their periodically triggered builds to work. – Solders May 24 '21 at 08:20
so - multi branch is a different style of pipeline than declarative, if i understand correctly. this is an answer to a different question if that is the case. – Dave Ankin Feb 02 '23 at 01:00
a multi-branch pipeline can be either declarative or scripted. This answer refers to a declarative multi-branch pipeline. See the [Jenkins Docs: Pipeline](https://www.jenkins.io/doc/book/pipeline/#declarative-versus-scripted-pipeline-syntax) for a comparison. – Julian Veerkamp Feb 03 '23 at 08:50

score 52 · Answer 2 · answered Apr 25 '17 at 17:28

52

If you are using a declarative style Jenkinsfile then you use the triggers directive.

pipeline {
    agent any
    triggers {
        cron('H 4/* 0 0 1-5')
    }
    stages {
        stage('Example') {
            steps {
                echo 'Hello World'
            }
        }
    }
}

answered Apr 25 '17 at 17:28

teeks99

3,585
2
30
38

21

Any way to make cron trigger only on `master` branch? To give some context: when team mates create a new feature branch and commit there Jenkins file should still trigger (via poll or push) but what I do not want is the cron trigger fire on these feature branches. – foobarto Jun 09 '17 at 10:33
Use: stage('Stage1') { when { branch "master" } steps { } } OR stage('Stage1 (Not master)') { when { not { branch 'master' } } steps { sh 'do-non-master.sh' }} – tr53 Jan 21 '20 at 14:08

score 39 · Answer 3 · edited Mar 23 '23 at 14:24

39

This is working for me:

pipeline {
  triggers {
    cron(env.BRANCH_NAME == 'development' ? 'H */12 * * *' : '')
  }
}

See more in this article

edited Mar 23 '23 at 14:24

t0r0X

4,212
1
38
34

answered Sep 05 '18 at 11:15

Paweł Iwaneczko

853
1
10
13

5

That just duplicates the answer by @Julian Veerkamp, including the linked Jira issue. – Ulrich Eckhardt Feb 21 '22 at 11:28
Not a duplicate! It's a different means of implementation inline rather than setting a variable outside the `pipeline` block. The devil is in the details with Jenkinsfile scripts, and the syntax is not always intuitive. SO THIS HELPS! – ingyhere Nov 23 '22 at 07:04

score 30 · Answer 4 · edited Aug 27 '16 at 08:04

30

I was able to find an example illustrating this an discarding old builds, which is also something I wanted.

Jenkinsfile in jenkins-infra/jenkins.io:

properties(
    [
        [
            $class: 'BuildDiscarderProperty',
            strategy: [$class: 'LogRotator', numToKeepStr: '10']
        ],
        pipelineTriggers([cron('H/30 * * * *')]),
    ]
)

edited Aug 27 '16 at 08:04

StephenKing

36,187
11
83
112

answered Aug 26 '16 at 18:20

geowa4

40,390
17
88
107

1

BTW for the first property you can use the `buildDiscarder` symbol to simplify syntax, as **Pipeline Syntax** should show. – Jesse Glick Jan 27 '17 at 17:53
1

It does not work in scripted pipelines under jenkins 2.79 (java.lang.UnsupportedOperationException: Undefined symbol ‘pipelineTriggers’) – gileri Sep 22 '17 at 15:11
2

Eric, just try with this for scripted pipelines: `pipelineTriggers([[$class: "TimerTrigger", spec: "H 1 * * *"]])` – nradev Jan 30 '18 at 17:04

merlachandra · Answer 5 · 2019-08-21T07:17:09.457

2

For Paramertized periodic runs or scheduled triggers, one could use as follows.

triggers{
    parameterizedCron env.BRANCH_NAME == "develop" ? '''H 03 * * * % buildSlave=vm1;testSlave=vm2;HYPERVISOR=vbox;VERSION=10.5.0.0
H 03 * * * % buildSlave=vm1;testSlave=vm2;HYPERVISOR=workstation;VERSION=10.5.0.0''' : ""
}

edited Aug 21 '19 at 07:17

answered Aug 20 '19 at 14:37

merlachandra

376
2
17

score 0 · Answer 6 · edited Dec 22 '20 at 13:15

I hit issues with the above solutions.
I'm not a Jenkins wizard so not sure if I am using an old format/syntax or something, but the following is working for me.

#!/usr/bin/env groovy
properties(
    [
        pipelineTriggers([
                [
                    $class: 'TimerTrigger',
                    spec: 'H 7,19 * * *'
                ]
         ])
    ]
)

Determined from: https://github.com/jenkinsci/jenkins/blob/master/core/src/main/java/hudson/triggers/TimerTrigger.java

"Build Periodically" with a Multi-branch Pipeline in Jenkins

6 Answers6

Linked

Related