[JIRA] (JENKINS-57964) Documentation unclear for node() in scripted pipeline

1 view
Skip to first unread message

leemeador@java.net (JIRA)

unread,
Jun 11, 2019, 11:24:05 AM6/11/19
to jenkinsc...@googlegroups.com
leemeador created an issue
 
Jenkins / Improvement JENKINS-57964
Documentation unclear for node() in scripted pipeline
Issue Type: Improvement Improvement
Assignee: Unassigned
Components: pipeline
Created: 2019-06-11 15:23
Environment: n/a
Labels: documentation scripted node
Priority: Minor Minor
Reporter: leemeador

On this page in the documentation, it describes node().

https://jenkins.io/doc/pipeline/steps/workflow-durable-task-step/#node-allocate-node

 

Some examples of using the operators have no quotes. Some have quotes around the individual components (eg. 'linux' || 'osx'). None have the full correct syntax (eg. 'linux || osx').

 

If you use the form with the quotes around the individual components, you get an error saying that node() does not allow a boolean argument. Of course, we are used to the error messaages occasionally having no useful information.

 

I suggest changing the documentation to NOT include the example with quotes around the components. (It says exactly this: For example, "osx (10.11)" || "Windows Server")

 

I also suggest putting something up at the top that shows a full example with an expression as well as a single agent's label.

Add Comment Add Comment
 
This message was sent by Atlassian Jira (v7.11.2#711002-sha1:fdc329d)
Reply all
Reply to author
Forward
0 new messages