TeamCity Minimal Build Agent

!official JetBrains project

这是官方的JetBrains TeamCity最小构建代理镜像。

有关标签和组件的更多详情，请参见此处。

TeamCity构建代理连接到TeamCity服务器并生成实际的构建进程。您可以使用jetbrains/teamcity-server镜像运行TeamCity服务器。有关如何一次性启动TeamCity服务器和代理的方法，请参见这些Docker Compose示例。

镜像概述和主要用途

该最小镜像仅包含TeamCity代理，不附带VCS客户端等任何工具。适用于简单构建任务，并可作为自定义镜像的基础。对于Java或.NET开发，建议使用默认构建代理镜像jetbrains/teamcity-agent。

核心功能和特性

• 轻量级设计：仅包含TeamCity代理核心组件，无额外开发工具（如VCS客户端）
• 灵活扩展：可作为自定义镜像模板，按需添加构建工具
• 自动升级：连接到升级后的服务器时，代理会自动完成升级
• 跨平台支持：兼容Linux和Windows容器环境

使用场景和适用范围

适用场景

• 执行简单构建任务，无需依赖额外工具
• 作为基础镜像构建自定义代理（如添加特定构建工具）
• 资源受限环境中运行轻量级构建代理

不适用场景

• Java或.NET开发项目（推荐使用jetbrains/teamcity-agent）
• 需要VCS客户端（Git、SVN等）或构建工具（Maven、Gradle等）的复杂构建

使用方法和配置说明

拉取镜像

从Docker Hub仓库拉取TeamCity最小镜像：

jetbrains/teamcity-minimal-agent

启动容器

Linux容器

使用以下命令在Linux容器中启动TeamCity代理：

docker run -e SERVER_URL="<TeamCity服务器URL>" \
    -v <代理配置文件夹路径>:/data/teamcity_agent/conf \
    jetbrains/teamcity-minimal-agent

Windows容器

使用以下命令在Windows容器中启动：

docker run -e SERVER_URL="<TeamCity服务器URL>" `
    -v <代理配置文件夹路径>:C:/BuildAgent/conf `
    jetbrains/teamcity-minimal-agent

参数说明：

• <TeamCity服务器URL>：代理可访问的TeamCity服务器完整URL（localhost通常不可用，因其指向容器内部）
• <代理配置文件夹路径>：主机上用于持久化代理配置（如授权信息）的目录路径，每个代理需映射独立文件夹

自2020.1版本起，TeamCity代理Docker镜像在非root用户下运行。有关受影响的用例，请参阅升级说明。

首次运行代理时，需通过TeamCity服务器UI授权：在浏览器中访问未授权代理页面。详情参见TeamCity文档。代理授权信息存储在配置文件夹中，使用相同配置文件夹启动新容器时，代理名称和授权状态将保留。

环境变量配置

Windows容器限制

Windows容器的已知问题详情，请参见TeamCity文档。

自定义镜像

通过以下步骤基于该镜像创建自定义代理：

1. 启动基础容器并命名：

docker run -e SERVER_URL="<TeamCity服务器URL>" \
    -v <代理配置文件夹路径>:/data/teamcity_agent/conf \
    --name="my-custom-agent" \
    jetbrains/teamcity-minimal-agent

2. 进入容器修改配置或安装工具：

docker exec -it my-custom-agent bash

3. 提交容器为新镜像：

docker commit my-custom-agent <目标镜像仓库地址>

许可证

本镜像遵循TeamCity许可证。TeamCity可永久免费使用，限制为100个构建配置（任务）和3个代理。许可详情。

反馈

报告问题或建议至官方TeamCityissue跟踪器。

其他TeamCity镜像

• TeamCity Server
• 默认构建代理