Parameterized Scheduler

Before looking too deep here, take a look at the fork. That is the plugin registered in the Jenkins registry

A Jenkins Plugin to support setting parameters in the build schedule. Using multiple cron lines each ending with a % and some name=value pairs you can schedule your parameterized build to run with different parameters at different times. It may turn out that this improvement request JENKINS-16352 will be implemented in Jenkins core. Then this plugin will no longer be needed. My first thought is to try it out as a plugin.

Installation

Clone or fork to build the .hpi yourself (mvn package) or download the .hpi from my release. Then follow the Jenkins Plugin installation instructions

Configuration

After you save your project with some parameters (yes, save, then go back into the config page) you will see

Build periodically with parameters

in the Build Triggers section as shown here:

Parameterized Schedular Config

Configuration Example

The cron line before the % symbol is processed the same as the jenkins core Build periodically Schedule. Leave a space. Put in a %. Then add the name=value pairs you need for your project build parameters.

The idea was born from the need to use a different environment. To use a different TestNG configuration xml. In this example the env parameter will be set to int during the build triggered at 15 after each hour. Then env will be qa when the build runs at half past.

  #lets run against the integration environment at 15 past the hour
  15 * * * * % env=int
  #run QA too
  30 * * * % env=qa

Yes, of course you can set multiple parameters. Lets say you have three parameters:

Then you might want a schedule like the following:

  # leave spaces where you want them around the parameters. They'll be trimmed.
  # we let the build run with the default name
  5 * * * *%furniture=chair;color=black
  # now, let's override that default name and use Mr. Rubble.
  10 * * * * % furniture=desk; color=yellow; name=barney