[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

説明

コントリビューターガイド

技術スタック: java
領域: documentation
Issue 種別: documentation
難度: 2
推定時間: 1-3 hours
活動状況: stale
明確さ: clear
前提条件: knowledge of Jenkins label expressions
初心者向け度: 70
調査方針: 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.