Skip to main content
Question

Option to remove/exclude project name from jobref on project level?

  • April 22, 2026
  • 6 replies
  • 34 views

BugHunter42
Forum|alt.badge.img+1

Hello,

Is there a way to reference a job from another WITHOUT the referenced job’s project name ?

Some of our users use the SCM plugin to push job definition to a GitLab instance and share the referenced same jobs between two Rundeck instances used for two different purposes. Lets call them Instance A and Instance B.

Instance A has project_X containing a referenced job_1, from job_2. Both jobs definitions are pushed to GitLab instance and cloned to project_Y on Instance B

The problem is, while the UUID and jobs name are the same on both Instance A and Instance B because both jobs do the same EXACT thing as you would except (no modification on actual jobs, they different only in terms of which nodes they’re scheduled/executed on), projects names on tho other hand reflect the purpose/environment (testing, production, level-1 support…).

That naming scheme leads to different projects name even when the jobs are the similar in terms of jobs contents (steps, scripts, commands…), thus project_Y instead of project_X on Instance B

So we end up Instance A and Instance B both having job_2 calling job_1 but these jobs are in a differently named project between both instancei.

With the project name being part of job reference identifier, the end result is a broken job reference due to different job name. When instance B cloned job_1 and job_2 from git through the SCM plugin, those jobs were added inside project_Y but job_2 references job_1 as 

 

    }, {
"jobref" : {
[…]
},
"project" : "project_X",
"useName" : "true",
"uuid" : "job_1_UID"
}

As exported from Instance A (which indeed has those jobs inside project_X)

Instead of just

    }, {
"jobref" : {
[…]
},
"useName" : "…",
"uuid" : "job_1_UID"
}



Obviously, I’m not excepting Rundeck to deduce that the correct value should be either  "project" : "project_Y" or no "project" reference at all, (instead of "project" : "project_X")  in order for the job reference to work on Instance B (which has a project_Y instead of a project_X)


But I’m looking for a workaround to disable/ignore the jobref’s project parameter inside de job definition  

This use case isn’t limited to a a single referenced job. The project we encounter is  that they used this logic on multiple jobs so editing every single job to correct the referenced job is way too much work for them since these users have a loot of jobs. And until this is resolved, some of their jobs are broken.

One option would be the change the “project” value programmatically BUT I don’t know their projects/jobs well enough for write a script for them and they probably won’t comfortable with programmatically editing their jobs on Instance B.

6 replies

Forum|alt.badge.img
  • PagerDuty Team 📟
  • April 27, 2026

Maybe a good way to reference jobs in your scenario is to call them directly using the Run Job API call (in a script step) instead of calling them via the Job Reference Step. 


BugHunter42
Forum|alt.badge.img+1
  • Author
  • New Member 👋
  • April 27, 2026

That’s what I would do if it were my projects/jobs but it’s not 🤷🏻

Our users would refuse to edit their I-don’t-know-how-many-jobs/steps that references jobs to repalce them with API calls… They already refused to edit jobs on instance B to update de job references by simply re-selecting the referenced sub from the GUI, saying they have way many jobs to update :/
That’s why I’m looking for a work-around

And they’re not very comfortable with API requests, some users are more techy than others…

They are planing have a project in instance A with the same name as instance B so when they export the jobs with the SCM plugin from instanec A to instance B, the reference doesn’t break…

But when copy their jobs in instance A from the older project to the newer one, they will likely discover cloned jobs still references jobs in the older project, so unless they export job definition, edit project names in jobs definition (in JSON or YAML files) before re importing them back on the newer project, that won’t really resolve their problem in these older jobs, just avoid it for newer jobs. 


  • PagerDuty Team 📟
  • May 4, 2026

Hi ​@BugHunter42 , can you share more details about the error your users are getting?
I just tried to replicate this on my sandbox (running 5.20.0) and I could download a job definition from one cluster, and upload it to another one with a different project name.

As long as the Job UUID in your job definition jobRef workflow step is correct, it should work fine.

It looks like Rundeck is only using the project property to show the dropdown in the UI when you try to edit the job reference workflow step, so it can list the jobs from that project when you click `Choose a Job`, but it shouldn’t affect the job execution.

On my example, I uploaded a job with the snippet below, into another cluster on a project called pagerduty-commons and it ran without issues.

sequence:
commands:
- description: By name
jobref:
group: Tests/Job-Ref
name: sanity check
nodeStep: 'true'
project: sandbox
uuid: 3e3c0caa-172a-49ec-873d-a296b44e1c99

 


BugHunter42
Forum|alt.badge.img+1
  • Author
  • New Member 👋
  • May 5, 2026

Hello ​@Bruno Dias 

What version of Rundeck are you using ?

The problem our users are are getting once it’s uploaded in the other Rundeck instance, is when they edit their jobs, the step with referenced job is greyed out with the error “job not found” written in red next to the referenced job.

They need to manually update each step to update de job reference to have a working project…

And since they have many references jobs with this issue, they are refusing to update their jobs to correct each and every step using referenced jobs.


  • PagerDuty Team 📟
  • May 5, 2026

Hi ​@BugHunter42 , I’m using RBA-SH 5.20.0.

Which version are you using?


BugHunter42
Forum|alt.badge.img+1
  • Author
  • New Member 👋
  • May 5, 2026

The bug issue has been detected on Rundeck Community 5.20.0 2026-04-02

I don’t know if job reference works exactly the same in RBA but as far as I know, the difference tends to me more on the GUI side + some API endpoints, not the internal engine for “shared’ functionalities (that are available on both Rundeck editions).