Docker Buildx Bake仅在CI环境中出现‘找不到目标’错误排查

1. GitLab CI环境残留旧Buildx缓存/上下文 #

本地重命名服务后，CI环境的Buildx可能缓存了旧的oem-web-prod配置上下文，导致无法识别新目标名称。

解决方法：

• 在CI脚本中先清理Buildx缓存并重建builder：

  docker buildx prune -f
  docker buildx rm my-builder || true
  docker buildx create --name my-builder --use
  

• 或者在bake命令中强制跳过缓存：

  docker buildx bake owmf-web-prod --print --no-cache
  

2. Docker/Buildx版本不兼容 #

本地与CI环境的Docker或Buildx版本差异，可能导致对docker-compose.yml的解析逻辑不一致，旧版本无法识别新服务的配置。

解决方法：

• 在CI脚本中升级到与本地一致的版本，示例：

  # 升级Docker
  curl -fsSL https://get.docker.com | sh
  # 安装指定版本Buildx
  mkdir -p ~/.docker/cli-plugins/
  curl -SL https://github.com/docker/buildx/releases/download/v0.11.2/buildx-v0.11.2.linux-amd64 -o ~/.docker/cli-plugins/docker-buildx
  chmod +x ~/.docker/cli-plugins/docker-buildx
  

• 确保docker-compose.yml使用CI环境兼容的文件格式，比如顶部指定version: '3.8'。

3. CI执行上下文的文件路径/权限问题 #

CI环境中可能存在文件路径不符（如嵌套目录）或权限不足，导致Buildx无法读取配置文件。

解决方法：

• 添加调试命令确认文件状态：

  pwd
  ls -la
  cat docker-compose.yml
  

• 若指定配置文件，使用绝对路径：

  docker buildx bake owmf-web-prod --print -f $CI_PROJECT_DIR/docker-compose.yml
  

4. Buildx驱动差异 #

本地默认使用docker驱动，而CI中Buildx可能默认使用docker-container驱动，两者解析Compose服务的逻辑存在细微差异。

解决方法：

• 在CI中创建并使用docker驱动的builder：

  docker buildx create --driver docker --use
  docker buildx bake owmf-web-prod --print
  

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