GitLab流水线中docker-compose -c/--context参数无效问题求助

问题核心原因 #

容器内实际执行的是Docker Compose v1版本，而-c/--context是Docker Compose v2才新增的参数，v1完全不支持该功能，因此会抛出"unknown shorthand flag"错误。

为什么安装v2后问题仍存在？ #

• apk安装的是v1版本：docker:20.10-dind基于Alpine Linux，默认apk仓库提供的docker-compose包大概率是v1版本（比如Alpine 3.16及以前的仓库中，docker-compose包对应v1），所以通过apk add docker-compose安装的还是不支持context的旧版本。
• PATH优先级或软链接问题：手动下载v2二进制文件后，如果没有覆盖系统默认的docker-compose路径，或者新路径在PATH中的优先级低于旧v1的路径，执行docker-compose时还是会调用旧版本。比如旧v1在/usr/bin/docker-compose，而你把v2装到/usr/local/bin，但系统PATH中/usr/bin排在/usr/local/bin前面，就会优先执行v1。

验证方法 #

在CI流水线的执行步骤中，先添加如下命令确认当前使用的版本：

docker-compose --version

如果输出是docker-compose version 1.x.x，即可确认是版本问题。

解决办法 #

1. 替换系统默认的docker-compose
   下载v2二进制文件后，直接覆盖旧版本的路径：

# 下载v2.15.1二进制文件到系统默认路径
curl -L "https://github.com/docker/compose/releases/download/v2.15.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/bin/docker-compose
# 赋予执行权限
chmod +x /usr/bin/docker-compose

2. 使用Docker Compose v2的插件式命令
   Docker Compose v2支持作为Docker插件使用，命令格式为docker compose（无横杠），如果已经正确安装v2，可直接改用：

docker compose --context remote pull best-ever-app

3. 指定v2二进制的绝对路径执行
   如果不想覆盖旧版本，直接用v2文件的绝对路径运行：

/usr/local/bin/docker-compose -c remote pull best-ever-app

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