TeamCity On-Premises 2025.07 Help

项目设置

当您进入 编辑模式时,TeamCity 项目会显示一个侧边栏,其中的设置按类别分组。

项目设置

请注意,对于具有 权限不足的用户,其中一些设置可能无法访问。

常规

本节列出了基本的项目设置,例如其公开描述和名称,以及用于创建子项目、 构建配置流水线的按钮。

有关模板相关设置的更多信息,请参阅 为项目定义默认模板强制执行从模板中继承的设置 部分。

VCS 根目录

本节列出了此项目拥有的所有 VCS 根,无论它们是否附加到任何项目配置。

相关文章: 配置 VCS 根目录

参数

参数 选项卡允许您创建名称-值对,这些对可用于此项目及其子项目拥有的所有配置。

相关文章: 配置构建参数 | 输入和输出参数

配方

配方是自定义配置的 构建步骤 ,这些步骤不随 TeamCity 一起提供。 项目管理员可以通过以下方式添加配方:

  • 从常规构建步骤中提取配方。

  • 从 JetBrains Marketplace 下载由 TeamCity 开发人员或社区创建的配方。

本节允许您控制是否可以使用第二个选项。

相关文章: 使用配方

版本化设置

本节允许您设置代码即配置:将所有项目和构建配置存储在 Kotlin DSL 或 XML 格式的远程存储库中。

相关文章: 在版本控制中存储项目设置 | Kotlin DSL

连接

TeamCity 隧道 是一个实体,用于存储访问第三方服务资源所需的设置:VCS 托管、云托管提供商、镜像注册表等。 本节允许您创建可供此项目拥有的所有子项目和构建配置使用的连接。

相关文章: 配置连接

Maven 设置

此选项卡允许您上传 Maven 设置,这些设置将可用于单个 Maven 构建步骤。

相关文章: Maven 服务器端设置

问题跟踪器

与问题跟踪器的集成允许 TeamCity 在显示新的代码更改时显示到相应问题跟踪器工单的链接。 Jira、Bugzilla、YouTrack、GitHub、GitLab、Bitbucket(云、服务器、数据中心)和 Azure DevOps Server(前身为 TFS)开箱即用。

相关文章: 将 TeamCity 与问题跟踪器集成

云配置文件

本节允许您配置按需启动并在空闲时自动停止的云托管构建代理。 这些代理帮助您根据当前工作负载扩展 TeamCity 构建服务器。

您还可以在此处设置 Kubernetes 执行器,它作为 TeamCity 构建队列的独立协调器。

相关文章: 在云中托管构建代理 | 执行模式:外部 Kubernetes 集成

构建工件存储

构建工件存储 部分允许您为构建生成的工件配置外部存储(例如 S3 存储桶)。

相关文章: 配置 Artifacts 存储 | 制品迁移工具

SSL / HTTPS 证书

SSL / HTTPS 证书 选项卡允许您上传证书,这些证书在建立 HTTPS/SSL 连接时将被 TeamCity 视为可信。

相关文章: 上传 SSL 证书

VCS 身份验证令牌

此选项卡允许您跟踪现有访问令牌,并利用已配置的 OAuth 连接来颁发新令牌。 使用这些令牌设置需要访问第三方服务的对象的身份验证设置: VCS 根提交状态发布者拉取请求等。

相关文章: 管理可刷新访问令牌

不受信任的构建

向构建配置添加 VCS 触发器允许它们自动运行处理新提交的构建。 但是,如果您的配置针对的是公共存储库,并且已配置 Pull Request 功能,则此设置可能会带来安全风险:TeamCity 可以自动启动处理来自外部用户的恶意更改的构建。

本节允许您定义详细条件,以控制哪些拉取请求可以安全地自动处理,哪些需要指定团队成员的手动批准。

相关文章: 不受信任的构建

项目隔离

TeamCity 构建配置可以使用两种类型的 依赖项与其他配置交互:

这些依赖项是在上游配置中设置的,这意味着其他 TeamCity 项目的管理员可以添加对您配置的依赖项。 如果您的项目包含不应由外部项目触发或向其提供工件的敏感配置,请使用 项目隔离 设置来限制访问。

相关文章: 保护配置

SSH 密钥

本节允许您上传(或生成新的)私钥。 这些密钥允许构建配置使用 SSH 协议检出存储库。

相关文章: SSH 密钥管理

报告选项卡

如果您的报告工具以 HTML 格式生成报告,您可以通过自定义选项卡来扩展 TeamCity,以显示第三方报告工具提供的信息。

相关文章: 将第三方报告包含在构建结果中

使用情况报告

此选项卡默认隐藏,当您检查哪些实体依赖于特定 TeamCity 对象时会显示。 它帮助您查看对象的使用位置,并了解如果编辑或删除它,CI 工作流的哪些部分可能会受到影响。

  • VCS 根 — 根在其设置页面和 VCS 根目录 表中显示 查看用法 链接。 点击此链接以查看此根附加到的所有构建配置。

    VCS 根的使用情况报告
  • 模板 — 点击模板设置的 使用 选项卡以查看基于此模板的所有配置,以及将此模板用作默认模板的所有项目。

    模板的使用情况报告
  • 构建配置 — 点击配置设置的 使用 选项卡以查看依赖于此配置的所有配置。 依赖配置是指具有 快照和/或 工件依赖项的配置。

相关文章: 配置 VCS 根目录 | Build Configuration Template(构建配置模板) | 构建配置依赖项

清理规则

TeamCity 会定期执行服务器范围的清理,以删除过时数据:过时的构建、其工件、构建缓存等。 此计划活动在 管理员 | 清理设置 页面上配置。 清理规则 部分允许您设置覆盖全局设置的每项目规则。

相关文章: TeamCity 数据清理

共享资源

共享资源功能允许使用外部(对 CI 服务器而言)资源(例如测试数据库或具有有限连接数的服务器)限制并发运行的构建。

相关文章: 共享资源

NuGet Feed

如果您希望将 NuGet 包发布给有限的受众(例如,内部使用),可以将 TeamCity 用作 NuGet 源。 您可以为 TeamCity 项目配置多个 NuGet 供稿源。

内置的 TeamCity NuGet 源支持 v1、v2 和 v3 API 版本。

相关文章: 使用 TeamCity 作为 NuGet 供稿源

建议

此选项卡显示旨在解决活动 健康报告的自动 TeamCity 建议。

相关文章: 服务器健康状况

最后修改日期: 2025年 9月 3日