Help documentation

Pipeline labelling

Go maintains an internal counter to identify a pipeline. This number increases by 1 for each build. By default, Go will use this counter as the pipeline label. This label is also passed to your build as an environment variable: GO_PIPELINE_COUNTER . The pipeline counter increases even if a build fails.

The concept of pipeline counters was introduced in release 1.3.2. In order to maintain backward compatibility with historical data Go now uses negative values as counter for pipelines created by older releases of Go. Hence it is perfectly normal for a historical pipeline to have a negative counter with positive label.

Customising the pipeline label

You can create a custom label by setting the labeltemplate attribute on your pipeline. This will change the value that Go shows on its webpages. It will also change the value of the GO_PIPELINE_LABEL property that is passed to your build. You can refer to ${COUNT} or material names which are defined in the configuration of materials.

<pipeline name="cruise" labeltemplate="1.2.${COUNT}">  
  ...
</pipeline>