[JENKINS-28380] Give expression examples for restricting where builds can run · jenkinsci/jenkins#21113

2015-05-13T16:19:36.000Z

For the check-box "Restrict where this project can be run," there is nothing in the help that mentions what kind of expressions you can write. From trial and error, I deduced that "a || b" means "use either a or b as build nodes." I expected a comma, like other fields (eg. projects that can access archives, projects to run after this build, etc.) I'm sure there are other valid expressions, such as using "*". Can you please update the help for this field to include some examples? I ended up looking at the source on GitHub and guessed this from the use of Antlr. --- Originally reported by ashes999 , imported from: Give expression examples for restricting where builds can run status : Open priority : Minor component(s) : core label(s) : jenkins, newbie-friendly, user-experience resolution : Unresolved votes : 0 watchers : 2 imported : 2025-11-24 Raw content of original issue For the check-box "Restrict where this project can be run," there is nothing in the help that mentions what kind of expressions you can write. From trial and error, I deduced that "a || b" means "use either a or b as build nodes." I expected a comma, like other fields (eg. projects that can access archives, projects to run after this build, etc.) I'm sure there are other valid expressions, such as using "*". Can you please update the help for this field to include some examples? I ended up looking at the source on GitHub and guessed this from the use of Antlr. environment : Jenkins ver. 1.609. I don't know the JRE or OS, sorry (my guess in Windows OS) because I don't manage these machines.

(2 comments) (0 reactions) (0 assignees)Java (9,474 forks)batch import

component:coregood first issueimported-jira-issuejira-type:taskpriority:minorresolution:unresolvedux

Repository metrics

Stars: (25,266 stars)
PR merge metrics: (Avg merge 10d 9h) (93 merged PRs in 30d)

Description

Contributor guide

Research direction: Examine the Jenkins source code for the label expression parser (ANTLR grammar) and add practical examples to the help text for the 'Restrict where this project can be run' field.
Tech stack: java
Domain: ci cddocumentation
Issue type: Documentation
Difficulty: 2
Estimated time: 1-3 hours
Activity status: Fresh
Clarity: Clear
Prerequisites: Jenkins
Newbie friendliness: 85

Repository metrics

Description

Contributor guide

Get fresh easy issues in your inbox.