管道设置 | TeamCity On-Premises 文档

编辑管道设置

若要查看和编辑核心管道设置，请点击右上角的设置切换，然后点击可视化编辑器中作业周围的管道画布区域的任意位置。

您还可以从可视化编辑器切换到代码，直接编辑标记。

参数

参数是名称－值对，用于将原始值替换为引用。当 TeamCity 遇到参数引用（%\形参名称% ）时，会将其替换为实际的参数值。

TeamCity 支持两种参数层级：pipeline 参数和 job 参数。流水线参数同时可作为输入参数和输出参数。

作业参数},{ 被设计用于这些作业，以及依赖它的作业（通过 job.<source-job-ID>.<param-name> 语法）。如需了解详情，请参阅作业参数。
管道输入参数会在同一管道内的所有作业之间共享。下方示例演示了一个管道参数被传递到两个作业中。
parameters: PipelineParam: foo jobs: Job1: name: Job 1 steps: - type: script script-content: 'echo "Pipeline parameter: %PipelineParam%"' # prints 'foo' Job2: name: Job 2 dependencies: - Job1 parameters: env.Job2Param: '%PipelineParam% bar' # job parameter references pipeline input param steps: - type: script script-content: |- echo "Original pipeline parameter: %PipelineParam%" # prints 'foo' echo "Modified pipeline parameter: %env.Job2Param%" # prints 'foo bar'
当此管道作为构建链的一部分时，管道输出参数会共享给下游管道和构建配置。单独设置此类型可让你更好地控制哪些参数可以 Exposed，哪些应保持私密。
请注意，输出参数无法在同一管道内使用。
parameters: PipelineInputParam: foo output-parameters: PipelineOutputParam: bar jobs: Job1: name: Job 1 steps: - type: script script-content: |- # Prints 'foo' echo "Input param: %PipelineInputParam%" # Unresolved reference: no compatible agents echo "Output param: %PipelineOutputParam%"
有关构建链中参数的详情，请参见本节：管道依赖项。

Secret

Secret 是受保护的参数，用于存储敏感数据。您可以像使用常规参数一样引用它们，但其实际值在 TeamCity UI 与构建日志中均被隐藏。

如果您切换到管道的代码视图，您会注意到 secret 值被替换为用于存储这些值的 token 名称。 TeamCity 会自动创建这些 token，以避免通过远程存储的配置文件泄露 secret 数据。

以下代码段展示了可在管道的集成区域中替代密码使用的 secret。尝试暴露该 secret 的命令行脚本会在构建日志中打印“Secret value: *******”行。

jobs:
  Job1:
    name: Job 1
    steps:
      - type: script
        script-content: |-
          echo "Secret value: %registry-password%"
secrets:
  registry-password: credentialsJSON:c57c2732-1d8c-4c11-8724-f275085f4320

  

管道依赖项

本节允许在一个构建链中关联管道和构建配置。

在管道 "B" 的设置中为对象 "A" 添加依赖项时，将创建 "A → B" 链，其中：

对象 A 可以单独运行；
管道 B 启动时会自动触发对象 A。

"A" 可以是经典构建配置，也可以是其他管道。

管道依赖项有以下设置：

依赖于

请选择一个上游配置或管道，使其在当前编辑的管道启动前完成。

执行修订版本同步

指定是否应由 TeamCity 确保通过依赖项关联的两个对象使用相同修订的代码源。

修订同步已启用。：建议用于需要使用相同源状态的设置。例如，在 "A → B" 链中："A" 从修订 1.2 开始，完成后被提升为 "B"。构建 "B" 将在相同的 1.2 修订上运行，即使其最新修订为 1.4。
修订同步已禁用：当构建没有严格的源依赖项时（例如软件包和部署步骤），请使用此设置。此时，下游构建将使用最新可用的修订。例如，在 "A → B" 链中："A" 从修订 1.2 开始，完成后被提升为 "B"。构建 "B" 将在其最新的 1.4 修订上运行，该修订与 "A" 不一致。

有关此设置对构建链影响的详细信息，请参阅关闭了强制修订同步部分。

如果有合适的构建，则不要运行新构建

如果启用此选项，那么如果已经存在具有适当源修订版本的正在运行或已完成的依赖构建，TeamCity 将不会运行新的依赖构建。有关 TeamCity 用于确定可重用构建的标准信息，请参阅合适的构建。

在此情况下，当触发依赖（下游）构建时，依赖项（上游）构建也会被加入队列。然后，在收集到构建链的更改后，此依赖项构建将从队列中移除，并将依赖项设置为合适的已完成构建。

只使用合适的成功构建

新触发的构建只会使用成功完成的合适构建作为依赖。如果最新完成的合适构建失败，它将被重新运行。

依赖项失败时、依赖项启动失败或被取消时

这些设置允许控制当依赖项（上游）构建失败时，依赖（下游）构建是否应运行，以及如果运行，同样的构建问题是否应出现在其结果中。

运行构建，但添加问题：将运行依赖构建，并将问题添加到其中，状态更改为失败（如果问题之前未被静音）。
运行构建，但不添加问题：将运行依赖构建，但不会添加问题。
将构建标记为启动失败：依赖构建将不会运行，并将被标记为“ 启动失败”。
取消构建：依赖构建将不会运行，并将被标记为“ 已取消”。

下面的代码段演示了如何在代码中设置依赖项。

jobs:
  ...
dependencies:
- ReverseAndOverrideDep_JobParams_UpstreamPipeline:
  reuse: none

    

import jetbrains.buildServer.configs.kotlin.*
import jetbrains.buildServer.configs.kotlin.pipelines.*

object DownsteamPipeline : Pipeline({
    name = "Downsteam pipeline"
        dependencies {
            snapshot(UpstreamPipeline) {
                reuseBuilds = ReuseBuilds.NO
            }
        }
})

    