Docker镜像CMD指定的Supervisord在GitLab CI任务中未运行如何解决

根因说明 #

GitLab CI执行任务时，会强制覆盖镜像的默认CMD与ENTRYPOINT配置，转而启动shell进程执行script字段中定义的命令，因此你Dockerfile中配置的supervisord启动命令完全不会执行，自然会出现socket file not found的报错。

解决方案 #

方案1：直接在script中手动启动supervisord #

在脚本最开头增加supervisord启动命令即可，示例配置如下：

supervisor-test:
  image: some-image-name
  script:
    - /usr/bin/supervisord -d # 若你的supervisord配置文件不在默认路径，需加 -c /path/to/supervisord.conf 指定配置
    - sleep 10
    - supervisorctl status
  only:
    refs:
      - merge_requests

其中-d参数表示以守护进程（后台）模式启动，避免阻塞后续脚本执行。

方案2：修改镜像ENTRYPOINT实现自动启动 #

如果你不想每个任务都手动加启动命令，可以调整镜像配置，新增入口脚本自动拉起supervisord：

1. 新建入口脚本entrypoint.sh，内容如下：

#!/bin/bash
# 后台启动supervisord
/usr/bin/supervisord -d
# 执行GitLab CI传入的任务命令
exec "$@"

2. 修改Dockerfile，配置新的入口：

COPY entrypoint.sh /entrypoint.sh
RUN chmod +x /entrypoint.sh
ENTRYPOINT ["/entrypoint.sh"]
# 原CMD可保留，不影响GitLab CI任务执行

调整后所有使用该镜像的GitLab CI任务都会自动启动supervisord，无需额外配置。

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