Trigger jobs across controllers

Issue

  • I would like to trigger a job on another controller.
  • I would like to set a remote downstream job.

Environment

  • CloudBees Jenkins Platform (CJP), Client controllers (CC) connected to CloudBees Jenkins Operation Center (CJOC)

Resolution

Select a job which triggers a remote one and then go to Job Configuration > Build section > Add Build Step > Trigger builds on remote/local projects option.

This configuration allows you to trigger another exiting job on a different CC (remote). The downstream job name part will autocomplete.

After you configure this you can trigger a new build and see the job executing on the other Jenkins controller:

Console output of triggering job:

Console output of triggered job (remote):

Note: In case you encounter an error similar to:

[operations-center-context] Could not find remote item at controller.example.com » remoteTriggerJobExample

Check at the CloudBees Jenkins Operations Center, under Manage Jenkins -> Configure Global Security -> Client controller security

  • Security Setting Enforcement > it needs to be one of the Single Sign-On options
  • Authentication mapping > it needs to Trusted controller with equivalent Security Realm

Then you need to re-connect your controllers back to your CloudBees Jenkins Operations Center as described in Configuring permissions for cross-controller triggers

Here is a demonstration how to do both these steps to fix the [operations-center-context] Could not find remote item at error:
gif of the triggerRemoteJob fix

Have more questions?

3 Comments

  • 0
    Avatar
    Arnaldo Garat

    Can this be done in Jenkinsfile?

  • 0
    Avatar
    RDM - Release Deployment Management

    How can this set up be done with JobDSL? What would the syntax looks like?

  • 0
    Avatar
    Ray Kivisto

    Can this be done in Jenkinsfile?

    Yes it can, the Pipeline step is called triggerRemoteJob. I recommend using the Snippet Generator to generate the Pipeline syntax: https://www.jenkins.io/doc/book/pipeline/getting-started/#snippet-generator 

Please sign in to leave a comment.