TeamCity On-Premises 2024.03 Help

TeamCity 维护模式

如果您在启动 TeamCity 时看到 TeamCity 维护页面,那就意味着这个 TeamCity 实例在启动前需要进行技术维护。 在大多数情况下,如果 TeamCity 安装期望的数据格式与 数据目录 或数据库中的数据格式不符,那么这个页面就会出现。 例如,在升级过程中,TeamCity 会在将数据转换为更新格式之前显示此页面。

出于安全原因,必须由具有对 TeamCity 服务器安装环境有管理访问权限的 系统管理员 进行维护。 如果您没有访问已安装 TeamCity 的计算机的权限,请告知您的系统管理员 TeamCity 需要技术维护。

如果您是 TeamCity 系统管理员,请通过在本页面的相应字段中输入 认证令牌来进行确认。 这个令牌可以在 teamcity-server.log 文件的 <TeamCity 安装目录>/logs 下找到。

在您已经提供了此令牌之后,您可以查看所需进行哪种类型的维护的详细信息。 可能由以下因素之一引起:

TeamCity 数据升级

在更新您的 TeamCity 实例时,已安装的 TeamCity 会检查 TeamCity 数据目录 和数据库是否使用了新 TeamCity 版本所要求的相同数据格式。 如果较新的版本需要数据转换,这个页面就会显示数据格式的详细信息。 请仔细检查以确保数据目录和数据库位置确实是服务器要使用的那些。

如果您以前未备份过数据,那么现在请使用提供的选项进行备份。 请注意,备份过程可能需要一些时间,尤其是在大型的 TeamCity 安装中。 其他备份方式在 这篇文章 中有详细介绍。

一旦 TeamCity 转换了数据,就无法降级。 如果您需要回退到更早的 TeamCity 版本,您只能通过从相应的备份中恢复数据来实现。

在数据备份后,点击 Upgrade

新的 TeamCity 数据格式

TeamCity 已经检测到数据格式对应于您试图运行的 TeamCity 版本之后的版本。 由于不支持降级,除非您提供与您要运行的 TeamCity 版本格式匹配的数据,否则 TeamCity 无法启动。 为此,请从备份中还原所需的数据。 请参考 此文章 获取操作指南。

TeamCity 启动错误

如果在 TeamCity 启动时遇到了严重错误,此页面将显示错误信息。 要继续,您需要修复错误原因并重新启动 TeamCity 服务器。

TeamCity 数据库创建

如果您在使用外部数据库设置 TeamCity或者迁移到外部数据库后看到此屏幕,请点击继续为 TeamCity 创建一个新的数据库。

最后修改日期: 16日 7月 2024年