GoCD 流水线标签

GoCD 维护一个内部计数器来标识流水线。每次构建时，该数字都会增加1。默认情况下，GoCD 将使用此计数器作为流水线标签。此标签也会作为环境变量传递给您的构建：GO_PIPELINE_COUNTER. 即使构建失败，流水线计数器也会增加。

修改默认的流水线标签

您可以通过设置标签模板字段来自定义流水线标签。这将更改 GoCD 页面上显示的值。它还会更改传递给流水线任务的GO_PIPELINE_LABEL环境变量的值。您可以引用 ${COUNT} 或在材料.

配置中定义的材料名称。labeltemplate的 GoCD 配置 XML 片段如下所示：

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

使用材料修订版

您可能还想将材料修订版包含到流水线标签中，以便通过材料修订版更容易找到 GoCD 流水线，反之亦然。例如，您可能有一个包含 Subversion 材料的流水线。以下示例展示了如何将 SVN 材料修订版包含到流水线标签中：

<pipeline name="main" labeltemplate="1.3.${COUNT}-${svn}">
  <materials>
      <svn url="http://server/path" materialName="svn" />
  <materials>
  ...
</pipeline>

使用截断的材料修订版

您可以选择截断材料修订版。当使用 Git 材料时这很有用，因为它们具有很长的修订号。通过添加“[:7]”，您可以获得一个简短的、截断的 Git 修订哈希版本，该版本正好有7个字符。（请注意，这个截断的 Git 修订版与“官方 Git 短修订版”之间有一个细微差别。后者可能是4-7个字符长，因为 Git 试图找到尽可能短的独特哈希值。请参阅git-rev-parse 文档下的“--short”以获取更多详细信息。）

<pipeline name="main" labeltemplate="15.1.${COUNT}-${git[:7]}">
    <materials>
        <git url="git://github.com/foo.git"  materialName="git" />
    <materials>
  ...
</pipeline>

使用上游流水线标签

您还可以将上游流水线的修订版包含到流水线标签中，例如，在不同的但相关的流水线之间共享相同的修订版：

<pipeline name="upstream" labeltemplate="1.3.${COUNT}-${svn}">
    <materials>
        <svn url="http://server/path" materialName="svn" />
    <materials>
  ...
</pipeline>

<pipeline name="downstream" labeltemplate="${upstream}">
    <materials>
        <pipeline pipelineName="upstream" stageName="dev" materialName="upstream" />
    <materials>
  ...
</pipeline>

在这种情况下，如果上游流水线的标签是“1.3.0-1234”，那么当下游流水线被触发时，下游流水线的标签也是“1.3.0-1234”。

使用参数

您还可以将参数包含到流水线标签中：

<pipeline name="main" labeltemplate="15.1.${COUNT}-#{param1}">
    <params>
        <param name="param1">default</param>
    </params>
  ...
</pipeline>

使用流水线级别的环境变量

从 GoCD18.10.0起，您还可以将流水线级别的环境变量包含到流水线标签中：

<pipeline name="main" labeltemplate="18.10.0.${COUNT}-${env:var}">
    <environmentvariables>
        <variable name="var">
          <value>default</value>
        </variable>
    </environmentvariables>
   ...
</pipeline>

另请参阅…

在配置中使用参数