在GitLab Runner中使用docker exec时遭遇容器未运行错误

核心原因 #

从docker ps的STATUS字段能看到容器已运行不足1秒，说明容器启动后立刻退出了——Docker容器的生命周期和主进程绑定，主进程结束容器就会停止，所以你执行docker exec的时候容器已经不在运行状态了。

排查与解决步骤 #

1. 先看容器启动日志找报错 #

在unit-test-job的script里加一行日志查看命令，先搞清楚容器为啥启动失败：

unit-test-job:
  stage: test
  script:
    - docker-compose up -d
    - docker ps
    - docker logs backend  # 新增这行看容器日志
    - docker exec backend python3 src/manage.py test

日志里会明确告诉你是代码报错、依赖缺失、配置文件找不到还是启动命令有问题。

2. 检查docker-compose.yml的backend配置 #

• 确认启动命令是前台运行：比如你的command是python3 src/manage.…，应该是runserver之类的前台命令，要是加了&让它后台运行，容器会直接退出。
• 检查挂载卷：如果你的代码是通过卷挂载进容器的，确认路径配置正确，不然容器里找不到src/manage.py会直接崩溃。
• 环境变量：有没有给容器设置必要的环境变量（比如数据库连接、DEBUG模式），缺失关键变量也会导致启动失败。

3. 修正流水线的镜像复用问题 #

你的build-job和unit-test-job是两个独立的Runner任务，build阶段构建的镜像不会自动传到test阶段，test阶段的docker-compose up会重新构建镜像，导致两次构建的环境可能不一致。解决方法：

• 在build阶段把构建好的镜像推到GitLab Container Registry，test阶段先拉取这个镜像再启动。
• 或者把build和test合并成一个job，避免跨job的镜像丢失问题。

4. 更高效的测试方式（可选） #

没必要先启动常驻服务再exec测试，直接让容器运行测试命令即可：

unit-test-job:
  stage: test
  script:
    - docker-compose run backend python3 src/manage.py test

这种方式不需要启动后台服务，跑完测试容器自动退出，更适合CI场景。

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