Agent Home Directory(代理主目录)
构建代理主目录 是代理安装的目录。
一台 构建代理 可以安装到任何目录中。 如果您选择安装构建代理并使用 TeamCity .tar.gz 分发版或 .exe 分发版,代理将被安置到 <TeamCity 安装目录>/buildAgent
中。 .exe
代理安装默认建议的目录是 C:\BuildAgent
。
代理将所有相关数据存储在其目录下。 唯一需要在操作系统中进行安装/卸载的地方是集成到 自动启动系统(例如,Windows 下的服务设置)。
代理目录
代理包括:
代理程序二进制文件(存储在
bin
、launcher
和lib
目录下)。 二进制文件可以自动从服务器更新以匹配服务器版本。代理插件和工具(存储在
plugins
和tools
目录下)。 这些是代理二进制安装的组成部分,由代理本身管理,每当需要时从 TeamCity 服务器自动更新。代理配置(存储在
conf
和launcher\conf
目录下)。 这是定义代理设置和行为的独特信息。代理工作目录(默认储存在
work
目录下,可通过代理配置进行配置)。代理辅助数据(存储在
system
、temp
、backup
、update
目录下)。 代理运行期间所需的数据。代理日志(存储在
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/:此目录包含构建代理的所有配置文件。
/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
— 这是构建代理用于其自己的临时文件的临时目录。 在代理重启时会被清理。