jetbrains/teamcity-minimal-agent

TeamCity Minimal Build Agent

!official JetBrains project

这是官方的https://www.jetbrains.com/teamcity/%E6%9C%80%E5%B0%8F%E6%9E%84%E5%BB%BA%E4%BB%A3%E7%90%86%E9%95%9C%E5%83%8F%E3%80%82

有关标签和组件的更多详情，请参见https://github.com/JetBrains/teamcity-docker-images/blob/master/context/generated/teamcity-minimal-agent.md%E3%80%82

https://www.jetbrains.com/help/teamcity/build-agent.html%E8%BF%9E%E6%8E%A5%E5%88%B0TeamCity%E6%9C%8D%E5%8A%A1%E5%99%A8%E5%B9%B6%E7%94%9F%E6%88%90%E5%AE%9E%E9%99%85%E7%9A%84%E6%9E%84%E5%BB%BA%E8%BF%9B%E7%A8%8B%E3%80%82%E6%82%A8%E5%8F%AF%E4%BB%A5%E4%BD%BF%E7%94%A8%60jetbrains/teamcity-server%60%E9%95%9C%E5%83%8F%E8%BF%90%E8%A1%8CTeamCity%E6%9C%8D%E5%8A%A1%E5%99%A8%E3%80%82%E6%9C%89%E5%85%B3%E5%A6%82%E4%BD%95%E4%B8%80%E6%AC%A1%E6%80%A7%E5%90%AF%E5%8A%A8TeamCity%E6%9C%8D%E5%8A%A1%E5%99%A8%E5%92%8C%E4%BB%A3%E7%90%86%E7%9A%84%E6%96%B9%E6%B3%95%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%A7%81%E8%BF%99%E4%BA%9Bhttps://github.com/JetBrains/teamcity-docker-samples%E3%80%82

镜像概述和主要用途

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

核心功能和特性

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

使用场景和适用范围

适用场景

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

不适用场景

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

使用方法和配置说明

拉取镜像

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

jetbrains/teamcity-minimal-agent

启动容器

Linux容器

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

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

Windows容器

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

powershell
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用户下运行。有关受影响的用例，请参阅https://www.jetbrains.com/help/teamcity/upgrade-notes.html#UpgradeNotes-AgentDockerimagesrunundernon-rootuser%E3%80%82

首次运行代理时，需通过TeamCity服务器UI授权：在浏览器中访问未授权代理页面。详情参见https://www.jetbrains.com/help/teamcity/build-agent.html%E3%80%82%E4%BB%A3%E7%90%86%E6%8E%88%E6%9D%83%E4%BF%A1%E6%81%AF%E5%AD%98%E5%82%A8%E5%9C%A8%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E5%A4%B9%E4%B8%AD%EF%BC%8C%E4%BD%BF%E7%94%A8%E7%9B%B8%E5%90%8C%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E5%A4%B9%E5%90%AF%E5%8A%A8%E6%96%B0%E5%AE%B9%E5%99%A8%E6%97%B6%EF%BC%8C%E4%BB%A3%E7%90%86%E5%90%8D%E7%A7%B0%E5%92%8C%E6%8E%88%E6%9D%83%E7%8A%B6%E6%80%81%E5%B0%86%E4%BF%9D%E7%95%99%E3%80%82

环境变量配置

Windows容器限制

Windows容器的已知问题详情，请参见https://www.jetbrains.com/help/teamcity/known-issues.html#KnownIssues-WindowsDockerContainers%E3%80%82

自定义镜像

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

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

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

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

bash
docker exec -it my-custom-agent bash

3. 提交容器为新镜像：

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

许可证

本镜像遵循https://www.jetbrains.com/teamcity/buy/license.html%E3%80%82TeamCity%E5%8F%AF%E6%B0%B8%E4%B9%85%E5%85%8D%E8%B4%B9%E4%BD%BF%E7%94%A8%EF%BC%8C%E9%99%90%E5%88%B6%E4%B8%BA100%E4%B8%AA%E6%9E%84%E5%BB%BA%E9%85%8D%E7%BD%AE%EF%BC%88%E4%BB%BB%E5%8A%A1%EF%BC%89%E5%92%8C3%E4%B8%AA%E4%BB%A3%E7%90%86%E3%80%82https://www.jetbrains.com/help/teamcity/licensing-policy.html%E3%80%82

反馈

报告问题或建议至官方TeamCityhttps://youtrack.jetbrains.com/issues/TW。

其他TeamCity镜像

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