matrixsolutions/teamcity-agent-generic Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

TeamCity Linux构建代理镜像

镜像概述

该镜像为TeamCity提供Linux构建代理，旨在支持TeamCity环境中的所有Linux矩阵构建任务。团队经讨论决定采用统一代理设计，而非为不同工具/构建运行器创建单独代理，以避免维护多个代理带来的额外成本，同时确保构建环境的一致性。

核心功能与特性

• 统一代理设计：无需为不同工具或构建运行器维护多个代理，降低维护复杂度
• Linux矩阵构建支持：专门优化用于TeamCity上的各类Linux平台构建任务
• 环境一致性：提供标准化的构建环境，减少因环境差异导致的构建问题

使用场景

适用于TeamCity持续集成/持续部署(CI/CD)环境中，需要在Linux平台上执行的各类构建任务，尤其适合需要统一构建环境、简化代理管理的团队。

使用方法

基本部署

通过Docker运行TeamCity Linux构建代理，需配置连接TeamCity服务器的必要参数（如服务器URL、代理授权令牌等）。

Docker Run命令示例

bash
docker run -d \
  --name teamcity-linux-agent \
  -e SERVER_URL="[***]" \
  -e AGENT_NAME="linux-build-agent" \
  -v /var/run/docker.sock:/var/run/docker.sock \
  teamcity-linux-agent

关键环境变量说明

• SERVER_URL：TeamCity服务器的URL地址
• AGENT_NAME：构建代理的名称（在TeamCity服务器中显示）
• 其他可选参数可参考TeamCity官方文档配置代理连接信息

注意事项

• 确保代理容器能网络访问TeamCity服务器
• 根据构建需求挂载必要的宿主机目录（如源代码目录、构建缓存等）
• 如需使用特定构建工具，可通过Dockerfile扩展基础镜像或在运行时挂载工具目录