docker pull指定platform参数拉取架构对应镜像异常解决方案

你看到的相同sha256摘要不属于单架构镜像本身，是oraclelinux:7-slim标签对应的**多架构镜像索引（OCI Manifest List，也叫Fat Manifest）**的哈希值。
按照OCI镜像规范，多架构镜像索引是一个统一的入口文件，内部记录了同一个标签下不同架构、不同操作系统对应的单架构镜像的真实哈希和元数据。docker pull命令默认输出的Digest字段就是这个索引文件的哈希，只要索引本身的内容没有更新，不管你通过--platform参数指定拉取哪个架构的子镜像，输出的索引哈希都会完全一致，这不是功能异常，是正常设计。
你可以执行以下命令验证拉取结果的正确性：

# 拉取amd64版本后检查架构
docker pull --platform=linux/amd64 oraclelinux:7-slim
docker inspect oraclelinux:7-slim | grep Architecture
# 输出值为 "amd64"

# 拉取arm64版本后检查架构
docker pull --platform=linux/arm64 oraclelinux:7-slim
docker inspect oraclelinux:7-slim | grep Architecture
# 输出值为 "arm64"

实际拉取到本地的镜像架构是完全符合参数指定的，只是pull命令的输出没有展示单架构子镜像的哈希，造成了“拉到同一个镜像”的误解。

根据你的Runner版本和使用场景，选以下任意一种方案即可：

• 新版Runner直接配置platform字段
  14.0及以上版本的GitLab Runner（Docker executor）原生支持在job的image配置中指定平台，不需要额外处理，配置示例：

  amd64_build_job:
    stage: build
    image:
      name: oraclelinux:7-slim
      platform: linux/amd64
    script:
      - uname -m # 执行后输出x86_64，验证架构正确
  
  arm64_build_job:
    stage: build
    image:
      name: oraclelinux:7-slim
      platform: linux/arm64
    script:
      - uname -m # 执行后输出aarch64，验证架构正确
  

• 旧版Runner通过自定义tag区分架构
  如果Runner版本较低不支持platform配置，可提前在Runner所在节点执行拉取、打tag操作：

  # 给amd64版本打自定义tag
  docker pull --platform=linux/amd64 oraclelinux:7-slim
  docker tag oraclelinux:7-slim oraclelinux:7-slim-amd64
  # 给arm64版本打自定义tag
  docker pull --platform=linux/arm64 oraclelinux:7-slim
  docker tag oraclelinux:7-slim oraclelinux:7-slim-arm64
  

  CI配置中直接使用打好的自定义tag即可，避免架构混淆。
• 通过单架构真实digest固定镜像版本
  如果需要严格固定镜像版本避免上游更新影响，可以先执行docker manifest inspect oraclelinux:7-slim，从返回的JSON内容中找到linux/amd64、linux/arm64分别对应的单架构manifest哈希，直接用哈希拉取镜像，示例：

  amd64_build_job:
    stage: build
    image: oraclelinux@sha256:[这里替换为查询到的amd64对应单架构哈希]
    script:
      - echo "running on amd64"
  
  arm64_build_job:
    stage: build
    image: oraclelinux@sha256:[这里替换为查询到的arm64对应单架构哈希]
    script:
      - echo "running on arm64"
  

  这种方式不需要依赖platform参数，会直接拉取对应架构的镜像，不会出现架构拉错的问题。

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