TeamCity On-Premises 2024.03 Help

Agent Home Directory(代理主目录)

构建代理主目录 是代理安装的目录。

一台 构建代理 可以安装到任何目录中。 如果您选择安装构建代理并使用 TeamCity .tar.gz 分发版或 .exe 分发版,代理将被安置到 <TeamCity 安装目录>/buildAgent 中。 .exe 代理安装默认建议的目录是 C:\BuildAgent

代理将所有相关数据存储在其目录下。 唯一需要在操作系统中进行安装/卸载的地方是集成到 自动启动系统(例如,Windows 下的服务设置)。

代理目录

代理包括:

  • 代理程序二进制文件(存储在 binlauncherlib 目录下)。 二进制文件可以自动从服务器更新以匹配服务器版本。

  • 代理插件和工具(存储在 pluginstools 目录下)。 这些是代理二进制安装的组成部分,由代理本身管理,每当需要时从 TeamCity 服务器自动更新。

  • 代理配置(存储在 conflauncher\conf 目录下)。 这是定义代理设置和行为的独特信息。

  • 代理工作目录(默认储存在 work 目录下,可通过代理配置进行配置)。

  • 代理辅助数据(存储在 systemtempbackupupdate 目录下)。 代理运行期间所需的数据。

  • 代理日志(存储在 logs 目录下):存储调查代理问题所需的内部代理日志的目录。

代理文件修改

代理配置目录是唯一一个设计为用户可以编辑的文件的目录。 所有其他目录都不应该被用户编辑。

代理工作目录的内容可以被删除(但只能被完全删除)。 这将导致所有受影响的构建进行一次干净签出

存储代理辅助数据的目录内容可以被删除(但只能全部删除,且在代理未运行时)。 在此代理上删除数据可能会在下次构建过程中产生额外操作,但这只是会影响性能,不应影响稳定性。

重要的 代理文件和目录

  • /bin

    • agent.bat — 这是一个批处理脚本,用于在 Windows 控制台下启动 / 停止构建代理。

    • agent.sh — 用于启动/停止 Linux/Unix 下的构建代理的 shell 脚本。

    • service.install.bat — 批处理文件,用于将构建代理安装为 Windows 服务。 参见 相关部分

    • service.start.bat — 使用已安装的构建代理服务启动构建代理。

    • service.stop.bat — 停止已安装的构建代理服务。

    • service.uninstall.bat — 用于卸载当前安装的构建代理 Windows 服务的批处理文件。

  • /conf/:此目录包含构建代理的所有配置文件。

    • buildAgent.properties主配置文件。 这个文件是由 TeamCity 服务器 .exe 安装程序和构建代理 .exe 安装程序生成的。

    • buildAgent.dist.properties — 这是一个样本配置文件。 您可以将其重命名为 buildAgent.properties 以创建初始代理配置文件。

    • teamcity-agent-log4j.xml — 构建代理日志设置。 有关详细信息,请参考文件内的注释或者log4j 手册

  • /launcher/conf/

    • wrapper.conf.template — 用作创建原始配置的模板的示例配置文件。

    • wrapper.conf — 当前构建代理的 Windows 服务配置。 这是一个 Java Service Wrapper 配置的 java 属性文件。 有关详细信息,请查阅文件内的注释或 Java Service Wrapper 文档。

  • /logs

    • launcher.log — 构建代理启动器的日志。

    • teamcity-agent.log — 主构建代理日志。

    • wrapper.log — Java Service Wrapper 的日志。 只有在构建代理以 Windows 服务的形式运行时才可用。

    • teamcity-build.log — 来自构建的日志。

    • upgrade.log — 来自构建代理升级过程的日志。

    • teamcity-vcs.log — 代理端签出日志。

  • /system

    • .artifacts_cache — 构建所有工件的缓存;可以被配置

  • /temp:临时目录;路径可以在 buildAgent.properties 文件中被覆盖。

    • agentTmp — 是构建代理在构建过程中用于存储与构建相关文件的临时目录。 在每次构建后进行清理。

    • buildTmp—— 设定为构建过程默认的临时目录,并在每次构建后被清理

    • globalTmp — 这是构建代理用于其自己的临时文件的临时目录。 在代理重启时会被清理。

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