如何从GitLab容器仓库拉取指定tag版本的terraform-images镜像？

1. 修正镜像标签格式 #

你当前使用的标签0.40.2可能不符合该镜像仓库的命名规则，项目仓库的标签是v0.40.2，对应的镜像标签可能需要带上v前缀，尝试执行：

docker pull registry.gitlab.com/gitlab-org/terraform-images/stable:v0.40.2

2. 确认镜像仓库的实际可用标签 #

项目的仓库标签和容器镜像标签不一定完全对应，你可以直接查看该项目的Container Registry页面，确认stable镜像下的所有可用标签：

• 进入项目的Packages & Registries -> Container Registry
• 找到registry.gitlab.com/gitlab-org/terraform-images/stable镜像，查看其所有发布的tag，确保你要拉取的版本存在且格式正确

3. 验证镜像的存在性 #

使用docker manifest inspect命令检查目标镜像是否存在，避免因网络或缓存问题误判：

docker manifest inspect registry.gitlab.com/gitlab-org/terraform-images/stable:0.40.2

如果返回manifest unknown，说明该tag确实不存在，需要更换为正确的tag。

4. 清理本地Docker缓存后重试 #

如果本地有无效缓存干扰拉取，可以清理缓存后重新尝试：

docker system prune -a

执行完成后再拉取正确的镜像标签。

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