jetbrains/teamcity-agent

TeamCity 构建代理

!official JetBrains project

这是官方https://www.jetbrains.com/teamcity/%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-agent.md%E3%80%82

https://www.jetbrains.com/help/teamcity/build-agent.html%E7%94%A8%E4%BA%8E%E8%BF%9E%E6%8E%A5TeamCity%E6%9C%8D%E5%8A%A1%E5%99%A8%E5%B9%B6%E7%94%9F%E6%88%90%E5%AE%9E%E9%99%85%E6%9E%84%E5%BB%BA%E8%BF%9B%E7%A8%8B%E3%80%82%E5%8F%AF%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%E5%A6%82%E9%9C%80%E4%BA%86%E8%A7%A3%E5%A6%82%E4%BD%95%E4%B8%80%E6%AC%A1%E6%80%A7%E5%90%AF%E5%8A%A8%E6%9C%8D%E5%8A%A1%E5%99%A8%E5%92%8C%E4%BB%A3%E7%90%86%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%A7%81https://github.com/JetBrains/teamcity-docker-samples%E3%80%82

本镜像提供适用于Java开发的TeamCity代理，基于jetbrains/teamcity-minimal-agent扩展，具备更多优势，例如：

• 支持Git或Mercurial的客户端检出
• 更多预安装构建工具
• Linux环境下的"docker-in-docker"支持

使用方法

拉取镜像

从Docker Hub拉取TeamCity代理镜像：

jetbrains/teamcity-agent

启动容器

Linux容器

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

Windows容器

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

其中，<TeamCity服务器URL>是代理可访问的服务器完整URL。注意："localhost"通常不可用，因容器内的"localhost"指向容器自身。

环境变量

• SERVER_URL：代理连接的TeamCity服务器URL（必填）
• AGENT_NAME：（可选）代理在TeamCity UI中的名称，未设置则自动生成
• AGENT_TOKEN：（可选）代理授权令牌，未设置时需通过TeamCity UI授权
• OWN_ADDRESS：（可选，仅Linux）代理绑定的IP地址，自动检测
• OWN_PORT：（可选，仅Linux）代理绑定的端口，默认9090
• DOCKER_IN_DOCKER：（可选，仅Linux）启用容器内Docker服务

持久化Checkout目录

重启代理容器后默认会重新检出构建源。如需避免此情况，需挂载以下目录以持久化代理状态：

1. 已检出的源码目录：-v /opt/buildagent/work:/opt/buildagent/work
2. 代理内部缓存：-v /opt/buildagent/system:/opt/buildagent/system

除非通过docker.sock使用Docker Wrapper，否则可自定义主机上的路径前缀。

运行需Docker的构建

如需在构建中使用Docker守护进程，有两种方案：使用主机Docker（docker-out-of-docker）或在容器内启动Docker（docker-in-docker）。注意：两种方案均需信任构建任务，因构建可能获取主机root权限，详情参见https://cheatsheetseries.owasp.org/cheatsheets/Docker_Security_Cheat_Sheet.html%E5%8F%8Ahttps://www.jetbrains.com/help/teamcity/security-notes.html%E3%80%82

使用主机Docker

通过挂载主机Docker套接字实现，共享主机Docker缓存，但存在安全风险：

docker run -e SERVER_URL="<TeamCity服务器URL>" \
    -u 0 \
    -v <代理配置目录路径>:/data/teamcity_agent/conf \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /opt/buildagent/work:/opt/buildagent/work \
    -v /opt/buildagent/temp:/opt/buildagent/temp \
    -v /opt/buildagent/tools:/opt/buildagent/tools \
    -v /opt/buildagent/plugins:/opt/buildagent/plugins \
    -v /opt/buildagent/system:/opt/buildagent/system \
    jetbrains/teamcity-agent

-v /opt/buildagent/*挂载是使用https://www.jetbrains.com/help/teamcity/docker-wrapper.html%E7%9A%84%E5%BF%85%E8%A6%81%E6%9D%A1%E4%BB%B6%E3%80%82%E8%8B%A5%E7%9C%81%E7%95%A5%EF%BC%8C%E5%88%99Docker Wrapper不可用，但可运行多个代理（需指定不同配置目录）。

在容器内启动Docker

容器内启动独立Docker守护进程，需使用--privileged标志及带-linux-sudo后缀的镜像：

docker run -e SERVER_URL="<TeamCity服务器URL>" \
    -u 0 \
    -v <代理配置目录路径>:/data/teamcity_agent/conf \
    -v docker_volumes:/var/lib/docker \
    --privileged -e DOCKER_IN_DOCKER=start \
    jetbrains/teamcity-agent:2021.1.1-linux-sudo

-v docker_volumes:/var/lib/docker用于解决aufs文件系统及Windows主机启动时的问题（https://youtrack.jetbrains.com/issue/TW-52939%EF%BC%89%E3%80%82%E5%A4%9A%E4%BB%A3%E7%90%86%E9%9C%80%E6%8C%87%E5%AE%9A%E4%B8%8D%E5%90%8C%E5%8D%B7%EF%BC%8C%E5%A6%82%60agent1_volumes:/var/lib/docker%60%E3%80%82

Windows容器限制

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

自定义镜像

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

1. 启动基础代理容器：

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

2. 进入容器：

docker exec -it my-customized-agent bash

3. 进行所需修改后退出，提交为新镜像：

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

许可证与反馈

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

问题反馈请提交至官方https://youtrack.jetbrains.com/issues/TW%E3%80%82

其他TeamCity镜像

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