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 Label Template field 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.

Power users can still edit the config xml to achieve the same. The xml snippet to configure labelTempalte is below.

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

Using a pipeline in the labeltemplate:

    <pipeline name="my-dependent-pipeline" labeltemplate="${MY_PIPELINE}">
        <materials>
            <pipeline pipelineName="my-pipeline" stageName="my-stage"/>
        </materials>
        ...
    </pipeline>

Using a VCS material in the labeltemplate. In this example, the Subversion revision number will be used as the labeltemplate:

    <pipeline name="my-material-pipeline" labeltemplate="1.2.${SVN_MATERIAL}">
        <materials>
            <svn url="http://svn.example.com/" dest="svn" materialName="SVN_MATERIAL" />
        </materials>
        ...
    </pipeline>