如何让TeamCity构建完成后Docker Compose容器持续运行？

核心原因分析 #

• TeamCity自带的Docker Compose构建步骤会自动在构建结束后执行docker-compose down，你改用命令行步骤的思路是对的，但容器退出通常有这几个原因：
  1. 容器自身的启动命令是一次性任务（比如执行完脚本就退出），而非长期运行的服务
  2. 容器挂载了TeamCity构建代理的工作目录，构建完成后TeamCity会清理该目录，导致容器进程因依赖文件缺失而退出
  3. docker-compose up -d启动的进程与构建代理进程组关联，agent退出时连带终止了相关容器进程

具体解决方案 #

1. 确保容器启动命令为长期运行服务 #

检查你的docker-compose.yml，确保容器的command或镜像默认命令是长期运行的：

• 像Nginx、Apache这类官方服务镜像默认会前台运行，无需额外配置
• 如果是自定义镜像，避免用bash、sh这类会自动退出的命令，可临时用tail -f /dev/null测试保持容器运行，实际替换为你的服务启动命令
  示例配置：

services:
  my-service:
    image: my-custom-image
    command: ["tail", "-f", "/dev/null"] # 测试用，实际替换成你的服务启动指令

2. 避免挂载TeamCity构建工作目录 #

如果容器挂载了当前构建目录（比如./build:/app），构建完成后TeamCity会清理代理的工作目录，导致容器内挂载目录为空，触发进程退出。建议改用宿主机固定目录挂载：

services:
  my-service:
    volumes:
      - /opt/my-app-data:/app # 用宿主机固定目录替代构建临时目录

3. 解除docker-compose与构建进程的关联 #

在命令行步骤中执行以下命令，确保进程完全脱离构建代理的进程组：

docker-compose up -d
# 断开进程关联，避免agent退出时终止容器
disown -h %1

或者直接用以下命令彻底脱离：

nohup docker-compose up -d > /dev/null 2>&1 &
disown

4. 确保构建代理有权限操作宿主机Docker #

在Ubuntu服务器上，将TeamCity构建代理用户加入docker用户组，保证其能直接操作宿主机Docker daemon：

sudo usermod -aG docker teamcity
# 重启构建代理使配置生效
sudo systemctl restart teamcity-agent

验证与排查 #

构建完成后在宿主机执行docker ps查看容器状态，如果仍退出，查看容器日志定位具体原因：

docker logs <容器名称或ID>

内容的提问来源于stack exchange，提问作者Chris Wallis