TeamCity 数据备份

TeamCity 提供了多种备份其数据的方法：

• 从网页用户界面备份: 这是一个在网页用户界面中进行的操作（也可以通过 REST API 触发），用来在服务器运行期间创建备份。 建议定期进行维护备份。 对备份数据存在一些限制（请参阅下方的 相关部分）。 这个选项也可以在维护屏幕的升级中使用：在 TeamCity 服务器的较新版本首次启动时。

• 通过 maintainDB 命令行工具备份 ：与通过用户界面一样。 要包含所有数据，请在服务器 已停止 时使用该工具。

• 手动备份 ：如果您想手动管理备份程序，这将很适合。

• 您可能只需要 备份构建代理的数据。

note

我们强烈建议您在升级前备份 TeamCity 数据。 请注意 TeamCity 服务器 不支持降级。

您可以选择在用户界面中或通过在 maintainDB 中添加相应的参数来备份哪些数据。

TeamCity 允许备份以下数据：

• 数据存储在数据库中

• 服务器设置、项目和构建配置的设置（所有内容存储在 <TeamCity Data Directory>/配置 ），以及安全值

• 自定义插件（安装在 <TeamCity Data Directory>/plugins ）和数据库驱动程序（来自 <TeamCity Data Directory>/lib 目录）

• 补充数据：设置历史记录、触发器状态、插件数据等（所有内容位于 <TeamCity Data Directory>/system/pluginData 目录下）

• 构建日志

• 个人更改

以下数据 未包含 到备份中：

• Build artifacts（构建工件） （由于其大小）。 这包括构建工艺品，内部 NuGet 供稿包，覆盖报告，完成构建参数，设置摘要等等。 如果您需要备份工件，请在 从备份中还原 TeamCity 数据 之前手动保存 工件目录 的内容。

• 从 UI 备份： 运行中的构建和构建队列状态。 如果您想备份这些，停止 TeamCity 服务器并使用 maintainDB 工具。

• TeamCity 应用程序的手动自定义内容位于 <TeamCity Home> ，包括使用的服务器端口号，这些内容存储在 <TeamCity Home>/conf/server.xml 文件中。

• TeamCity 应用程序日志（位于 <TeamCity Home>/log）。

• 位于 <TeamCity Data Directory>下的任何手动创建的文件，这些文件不属于前面提到的项目。

推荐的方法 是执行 手动备份过程或定期从 UI运行备份（例如，通过 REST API自动化）所需的操作，使用“Basic”级别——这将确保备份所有重要数据，除了构建工件和构建日志。

构建工件和日志（如有必要）可以通过复制 <TeamCity Data Directory>/system/artifacts 下的文件手动备份。
如果选择备份日志，TeamCity 将在当前服务器上指定的 所有工件目录中搜索它们。

请注意，对于大型生产 TeamCity 安装，从数据库导出和导入数据可能不是最优解决方案，通过复制维护数据库备份可能是更好的选择；例如，请参阅 MySQL 数据库的相应 文档。