epicmorg/teamcity-agent

TeamCity 最小构建代理

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

构建代理 连接到 TeamCity 服务器并生成实际的构建进程。您可以使用 jetbrains/teamcity-server 镜像运行 TeamCity 服务器。

此最小镜像仅包含 TeamCity 代理，不附带版本控制系统客户端等工具。它适用于简单构建，也可作为自定义镜像的基础。对于 Java 或 .NET 开发，建议使用默认构建代理镜像 https://hub.docker.com/r/jetbrains/teamcity-agent/%E3%80%82

核心功能与特性

• 轻量级设计：仅包含基础代理组件，无额外开发工具
• 灵活扩展：可作为自定义构建环境的基础镜像
• 跨平台支持：可在 Linux 和 Windows 容器中运行
• 自动升级：连接到升级后的服务器时，代理会自动升级

使用场景

• 简单构建任务的执行
• 作为自定义构建环境的基础镜像
• 资源受限环境中的构建代理部署

如何使用此镜像

拉取镜像

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

jetbrains/teamcity-minimal-agent

启动容器

Linux 容器

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

Windows 容器

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

参数说明：

• SERVER_URL：TeamCity 服务器的完整 URL（必填），注意 localhost 通常不可用，因为它指向容器内部的本地主机
• <代理配置文件夹路径>：主机上用于持久化代理配置的目录，建议指定以保留授权状态等配置，每个代理需映射不同的文件夹

注意：自 2020.1 版本起，TeamCity 代理 Docker 镜像以非 root 用户运行。有关可能受影响的用例，请参考 升级说明。

代理授权

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

环境变量配置

Windows 容器限制

有关 Windows 容器中的已知问题，请参阅 TeamCity 文档。

自定义镜像

可通过以下步骤自定义镜像：

1. 运行基础容器：

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

2. 进入容器：

bash
docker exec -it my-customized-agent bash

3. 根据需求进行修改（安装工具、配置环境等）

4. 提交为新镜像：

bash
docker commit my-customized-agent <目标镜像仓库>

许可证

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

反馈

请将问题或建议报告至官方 TeamCity 问题跟踪器。

其他 TeamCity 镜像

• https://hub.docker.com/r/jetbrains/teamcity-server/
• https://hub.docker.com/r/jetbrains/teamcity-agent/