[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 评论) (0 反应) (0 负责人)Java (25,266 star) (9,474 fork)batch import

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

描述

贡献者指南

技术栈: java
领域: documentation
议题类型: 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.