What is the difference between a node, stage, and step in Jenkins pipelines?

Question

I'm trying to understand how to structure my Jenkins 2.7 pipeline groovy script. I've read through the pipeline tutorial, but feel that it could expand more on these topics.

I can understand that a pipeline can have many stages and each stage can have many steps. But what is the difference between a step(); and a method call inside a stage, say sh([script: "echo hello"]);. Should nodes be inside or outside of stages? Should the overall properties of a job be inside or outside a node?

Here is my current structure on an ubuntu master node:

#!/usr/bin/env groovy  node('master') {     properties([         [$class: 'BuildDiscarderProperty', strategy: [$class: 'LogRotator', numToKeepStr: '10']]     ]);      stage 'Checkout'         checkout scm      stage 'Build'         sh([script: "make build"]);      archive("bin/*"); } 

Answer 1

The concepts of node, stage and step are different:

• node specifies where something shall happen. You give a name or a label, and Jenkins runs the block there.

• stage structures your script into a high-level sequence. Stages show up as columns in the Pipeline Stage view with average stage times and colours for the stage result.

• step is one way to specify what shall happen. sh is of a similar quality, it is a different kind of action. (You can also use build for things that are already specified as projects.)

So steps can reside within nodes, (if they don't, they are executed on the master), and nodes and steps can be structured into an overall sequence with stages.