推送镜像至gitlab时出现:invalid tag: missing manifest digest

问题

推送 Docker 镜像到 GitLab 时出现 invalid tag: missing manifest digest 错误，原因是 Docker BuildKit 的 Provenance（构建溯源） 功能生成的元数据导致 Manifest 摘要异常。

解决方案：

最终解决办法

在构建镜像时添加 --provenance=false 禁用 Provenance，命令格式：

docker build --provenance=false -t <镜像名称>:<标签> .

其他的命令不用修改，只需要修改build命令即可完成上传。

注意：

--provenance=false的作用：这参数是禁用BuildKit的构建溯源功能，这个功能会生成额外的元数据，可能导致GitLab无法正确解析镜像摘要。添加这个参数后，构建镜像时会跳过生成这些元数据，从而避免摘要缺失的问题。但用户可能认为这会重新构建所有层，但实际上如果之前的构建缓存有效，Docker会利用缓存，只重建必要的部分。