TeamCity On-Premises 2026.1 Help

TeamCity 2026.1 中的新功能是什么

发布周期更新

从本次发布开始，我们回归到 2022 年前的版本编号方案：主要 TeamCity 版本将采用“YYYY.N”格式，其中“N”表示发布编号而不是月份。 此更改让发布周期更加可预测，并与其他 JetBrains 产品保持一致。

今年，我们还计划将 TeamCity On-Premises 和 Cloud 的发布节奏分开。 On-Premises 将继续每年获得两次主要版本发布。 云端版则会更频繁地更新，无需等待本地版主要版本发布即可提前获得新功能和改进。

Java 21 迁移

TeamCity 服务器和构建代理不再支持早于 Java 21 的 Java 版本。 请参阅本文以获取升级说明： 备忘单：在服务器和代理机器上更新 Java。

TeamCity CLI​

TeamCity 2026.1 引入了一种管理 TeamCity 实例的新方式：TeamCity CLI。 除了基于浏览器的 UI 和强大的 REST API 外，现在还可以直接在终端通过命令行工具与 TeamCity 交互。

在任意机器上安装 CLI，通过命令行即可检查构建状态、启动新构建、排查失败并处理许多其他例程任务。

TeamCity CLI 实际操作

了解更多...

与 AI 代理集成

2026.1 版本还让连接如聊天机器人和类代理 IDE 等 AI 工具至 TeamCity 更加便捷。 可在两种集成选项之间进行选择：

  • TeamCity <server-url>/app/mcp 端点提供了 MCP 工具 ，帮助 AI 代理与 TeamCity 交互。

  • TeamCity CLI 集成了一项 代理技能 ，帮助代理通过终端命令操作 TeamCity。

了解更多...

流水线增强功能

  • 2026.1 版本大幅增强了流水线在 CI/CD 工作流中的集成能力：现在可以 将其纳入构建链。 这样可以通过流水线对流水线、流水线对配置、配置对流水线等依赖项创建更精细的设置。

    流水线依赖项

  • 我们重新设计了构建详情侧边面板，包含所有常见的 构建结果选项卡（如总览、构建日志、参数等），为每次构建提供完整视图。 现在还新增了流水线/作业切换，可以按作业快速筛选这些选项卡，让流水线更易于检查、调试和故障排除。

    侧边面板中的流水线-作业切换。

  • 现在可以使用 自定义构建对话框 ，一键自定义参数运行流水线。

    TeamCity 中的运行构建按钮

  • 作业现在也可以使用以下原本仅适用于 构建配置的构建功能：

    在流水线中构建功能

  • 在编辑流水线 仓库 设置时，现在可以从所属父项目的现有 VCS 根中添加仓库。 此前，仅在新建流水线时才有选项复用根。

  • 所有通过 HTTP 凭据连接到 Git 仓库的流水线均支持 让这些流水线跟踪拉取请求并发布运行状态的仓库选项。 以前这些选项仅对基于 TeamCity OAuth 连接创建的流水线可用。

    流水线中的 CSP 和 PR

  • 已重新设计流水线参数，更好地支持流水线依赖项，并提供更加一致且直观的模型。

    • 作业不再区分输入参数和输出参数。 现在，所有作业参数会自动可用于同一流水线中的下游作业。

    • 流水线参数现在可以显式标记为输入或输出，使对哪些值 Exposed 给下游配置和流水线拥有更精细控制。

    • 父项目中的参数无需导入，即可自动为子流水线和作业所用。

  • 如果父项目启用了 版本化设置 ，流水线 YAML 会自动转换为 DSL。 目前流水线中的 DSL 支持有限：通过 TeamCity UI 所做更改显示在新 Kotlin DSL 选项卡中，但不会自动提交，这也会导致流水线无法运行。 请手动将这些更改提交到远程 .kts 文件，以恢复流水线的运行能力。

    管道中的 DSL

动态构建步进凭据

新的 构建范围令牌 功能允许构建安全地即时生成短效（最长 60 分钟）GitHub 访问令牌。 以参数形式传递给构建步进，实现无缝启用对仓库的访问。

主要设置

了解更多...

SSH 已知主机

SSH 密钥 页面现在新增了额外选项，允许 TeamCity 验证其所连接的 VCS 提供商，如主机公钥与已知条目不符则中止后续操作。

SSH 已知主机

了解更多...

第三方集成增强

Git

  • 出于安全原因，Git VCS 根默认不再支持 本地和 UNC 文件 URL。 要重新启用，可设置 teamcity.git.allowFileUrl=true 内部属性。

  • 在选择 浅克隆 Git 检出策略时，现在可以添加 teamcity.git.agent.shallowCloneDepth 和 teamcity.git.agent.submodules.shallowCloneDepth 参数以设置 --depth特性。

  • GitLab CE/EE 连接 现支持配置与系统 Web 挂钩的集成。 此增强让 TeamCity 可几乎实时地获得仓库变更通知，无需周期性地 轮询仓库。

  • 提交状态发布器 构建功能现在包含一个选项，可在向 Git VCS 提供商（GitHub、GitLab、Bitbucket 等）发布状态时设置自定义构建配置名称。

    GitHub 中的 CSP 状态值

Perforce

  • 以前版本的 TeamCity 在构建 Perforce 已搁置更改列表时，会用相应已搁置的文件替换检出文件。 自 2026.1 版本起，TeamCity 在取消搁置后运行 p4 resolve ，采用更完善的方法，以检测并解决冲突变更。

  • 在为 Perforce 构建配置触发自定义构建时，现在可指定多个 已搁置更改列表 ID。

Kubernetes

HashiCorp Vault

JIRA

  • 配置 本地 Jira 实例连接时，现在可以选择使用常规用户名/密码凭据或问题跟踪器端发放的个人访问令牌进行认证。

其他增强功能

  • 所有 TeamCity 构建配置现在都会在构建期间自动记录代理硬件用法。 此更改带来了以下更新：

    • PerfMon 构建功能现已不再需要，并更名为 性能监视器（旧版）。

    • 构建结果 页面上对应的选项卡现称为 性能监视器 ，表明数据不再隶属于已废弃的功能。

    • 新增 teamcity.perfmon.feature.enabled 参数，可为特定构建配置或项目禁用 CPU、磁盘和内存用法统计。

  • 试用版 TeamCity Enterprise 许可证用户现可使用 AI Assistant。

  • 可用的 获取工件来源... 选项现已包含 从同一链构建 ，若目标和来源配置/流水线不属于同一构建链，则构建失败。 以前仅有 来自相同链或最新完成的构建 选项可用。

  • 除 此构建配置的最大并发构建数。},{ 已存在于 通用构建配置设置外，新增 如果达到限制。 选项允许选择 TeamCity 是将多余构建排队，还是取消最早运行的实例以释放资源容量。

  • 我们已实现 override.dep.参数前缀，将来可能完全替换之前的 reverse.dep. 语法，适用于未来的 TeamCity 版本。 新参数可解析参数引用，不会强制将编辑内容推送到缺少匹配参数的配置或流水线。

  • SAML 认证插件现已随 TeamCity 一同分发，无需单独安装即可启用通过外部 SSO 提供商认证。

  • 我们 改进了 Gradle 插件中 Gradle 版本选择逻辑。 本次更改仅在构建日志中增加少量 info 级别记录，并无可见行为变化，但有助于提升插件整体稳定性。

升级说明

在升级之前，我们强烈建议您阅读有关版本 2026.1 相比 2025.11 中重要变化的信息。

已修复的问题

请查看 TeamCity 2026.1 发行说明 文章，以获取已实施功能和已修复问题的摘要。

路线图

参阅 TeamCity 路线图 和 TeamCity Pipelines 路线图 相关文章，详细了解未来的更新。

更新 TeamCity 本地部署

我们建议使用 自动更新 进行最简单且最可靠的升级。 有关升级过程和可用选项的更多信息，请参阅 升级 TeamCity 服务器和代理。

要下载任何 TeamCity 主要版本或错误修复版本的 .tar.gz 或 .exe 安装程序，请访问 以前版本的下载 文章。

对于在 Docker 容器中运行的 TeamCity 服务器，请参阅 本文。

您的反馈至关重要

我们非常重视您的反馈，鼓励您分享您的想法和建议。 请查看此链接以获取更多信息： 支持与故障排除。

2026年 8月 6日
升级说明TeamCity 2026.1 发布说明