TeamCity On-Premises 2026.1 Help

Pipelines Kotlin DSL.

在 TeamCity 2026.1 中,设置存储在 Kotlin DSL 的项目所拥有的管道可以自动将其设置转换为 Kotlin。 熟悉的 可视模式/YAML 开关将开始显示额外的 Kotlin DSL 选项卡。

管道中的 DSL

这样可以让你拥有一个没有任何管道“空白”的完整项目 DSL。

DSL 兼容性模式

为包含管道的项目启用版本化设置会根据管道的设置存储位置产生一些限制。

  • 如果 主管道仓库在启用项目版本化设置时将其 YAML 存储在服务器上,则会切换到 在 VCS 仓库中 模式,并且可以通过 TeamCity UI 部分编辑。 在 可视模式YAML 选项卡中进行的编辑会自动转换为 DSL,但无法自动保存或提交。 复制与新更改相关的生成 DSL,并手动提交到项目 .kts 文件。 在此之前,管道无法运行,因为其当前配置与远程文件中存储的不一致。

  • 如果主仓库已经将其配置文件存储为远程 YAML 文件,则可以通过 TeamCity UI 完全编辑该管道。 但是,项目 .kts 文件不会包含此管道的 Kotlin DSL,因此项目配置文件将不完整。

管道 DSL 实体

特定于管道的类声明在 jetbrains.buildServer.configs.kotlin.pipelines命名空间中。 该命名空间中的密钥对象有:

管道

表示管道。

DSL 文档: Pipeline

工作

表示作业。

DSL 文档: 作业

存储库

表示管道作业可以处理的仓库。 每个 流水线设置|仓库 条目对应一个 PipelineRepositoryEntry 实例,而作业则与 JobRepositoryEntry 对象配合使用。

DSL 文档: PipelineRepositoryEntry | JobRepositoryEntry

文件发布

指定应发布为工件、共享(与下游作业)文件或两者的文件。

DSL 文档: FilePublication

2026年 8月 6日