alexfurla/tc-custom-agent

自定义TeamCity多语言构建镜像文档

镜像概述

本镜像为基于官方TeamCity Build Agent的自定义镜像，专门优化用于构建.NET、Rust和Java类型项目。通过预集成主流开发工具链，提供开箱即用的多语言构建环境，适用于企业级CI/CD流程中统一构建环境的需求。

核心功能与特性

1. 多语言构建支持

• .NET项目构建：预装.NET SDK（支持.NET 6.0/7.0/8.0主流版本），包含dotnet CLI、MSBuild等工具
• Rust项目构建：集成Rust工具链（稳定版），包含cargo、rustc、rustfmt及常用 crate 依赖
• Java项目构建：内置OpenJDK（11/17 LTS版本），支持Maven、Gradle构建工具及javac编译器

2. 优化的构建环境

• 基于官方TeamCity Agent镜像构建，保持与TeamCity Server的原生兼容性
• 预配置构建缓存目录（NuGet、Cargo、Maven本地仓库），提升重复构建效率
• 支持多阶段构建流程，适配复杂项目的构建需求

使用场景与适用范围

• 企业CI/CD流水线中需要统一构建.NET、Rust、Java项目的场景
• 开发团队需要快速部署标准化构建环境的场景
• 多语言混合项目（如前端+后端）的集成构建流程
• 需要简化工具链配置的自动化测试与构建任务

使用方法与配置说明

基本使用（Docker Run）

docker
docker run -d \
  --name teamcity-multi-agent \
  -e SERVER_URL=http://your-teamcity-server:8111 \
  -e AGENT_NAME=multi-lang-agent-01 \
  -p 9090:9090 \
  -v agent-conf:/data/teamcity_agent/conf \
  -v nuget-cache:/root/.nuget/packages \
  -v cargo-cache:/root/.cargo \
  -v m2-cache:/root/.m2 \
  your-registry/teamcity-multi-agent:latest

Docker Compose配置

yaml
version: '3.8'

services:
  teamcity-server:
    image: jetbrains/teamcity-server:latest
    ports:
      - "8111:8111"
    volumes:
      - server-data:/data/teamcity_server/datadir
      - server-logs:/opt/teamcity/logs
    restart: unless-stopped

  multi-lang-agent:
    image: your-registry/teamcity-multi-agent:latest
    depends_on:
      - teamcity-server
    environment:
      - SERVER_URL=http://teamcity-server:8111
      - AGENT_NAME=multi-lang-agent
      - AGENT_WORK_DIR=/data/teamcity_agent/work
    volumes:
      - agent-conf:/data/teamcity_agent/conf
      - nuget-cache:/root/.nuget/packages
      - cargo-cache:/root/.cargo
      - m2-cache:/root/.m2
    restart: unless-stopped

volumes:
  server-data:
  server-logs:
  agent-conf:
  nuget-cache:
  cargo-cache:
  m2-cache:

核心环境变量配置

高级配置

• 工具链版本切换：通过BUILD_TOOLS_VERSIONS环境变量指定特定版本，例如：

  docker
  -e BUILD_TOOLS_VERSIONS=".net=8.0,java=17,rust=1.75.0"
  

• 代理资源限制：根据项目复杂度调整CPU/内存资源：

  docker
  --cpus=4 --memory=8g
  

注意事项

1. 数据持久化：必须挂载agent-conf卷以保存代理配置，避免重启后配置丢失
2. 网络连通性：确保Agent容器与TeamCity Server之间网络互通（推荐使用Docker网络或同一主机部署）
3. 缓存优化：挂载构建缓存卷（NuGet/Cargo/Maven）可显著提升重复构建速度
4. 资源需求：复杂项目构建建议分配至少4核CPU及8GB内存，避免构建超时
5. 版本兼容性：定期更新镜像以获取最新工具链安全补丁及功能更新

维护与更新

• 镜像更新周期：每月同步官方TeamCity Agent更新，并更新工具链至最新稳定版
• 版本标签规则：{teamcity-version}-{toolchain-version}（如2023.11.4-multi-1.0）
• 问题反馈：通过镜像仓库issue或项目维护***提交工具链兼容性问题