[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 (25,266 stars) (9,474 forks)batch import

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

Description

Contributor guide

Tech stack: java
Domain: documentation
Issue type: documentation
Difficulty: 2
Estimated time: 1-3 hours
Activity status: stale
Clarity: clear
Prerequisites: knowledge of Jenkins label expressions
Newbie friendliness: 70
Research direction: Locate the help file for the 'Restrict where this project can be run' field in the Jenkins source code, likely in core/src/main/resources/hudson/model/ as an HTML or properties file. Study the Antlr grammar used for label parsing (e.g., in core/src/main/java/hudson/model/Label.java) to understand valid expressions. Add examples such as 'a || b', 'a && !b', '*', 'windows' to illustrate the syntax.