npx cypress verify导致docker buildx多架构镜像构建失败

核心原因 #

cypress verify会启动Cypress的浏览器内核，这个操作依赖原生架构的底层图形库，QEMU的跨架构模拟无法正常支持这类需要硬件加速的操作，所以跨架构构建时执行该命令必然失败；而单架构本地构建没问题，是因为用的是原生架构环境，不需要模拟。

解决方案 #

1. 移除构建阶段的cypress verify

直接把RUN npx cypress verify从Dockerfile中删除即可——Cypress在运行测试（cypress run）时会自动完成验证步骤，无需在构建阶段提前执行。修改后的Dockerfile：

FROM cypress/base:16.18.1

WORKDIR /usr/src/app

RUN npm install cypress@12.4.1

如果一定要提前做验证，可以把该步骤放到容器启动时执行，比如写一个启动脚本：

FROM cypress/base:16.18.1

WORKDIR /usr/src/app

RUN npm install cypress@12.4.1

COPY entrypoint.sh /entrypoint.sh
RUN chmod +x /entrypoint.sh

ENTRYPOINT ["/entrypoint.sh"]

entrypoint.sh内容：

#!/bin/sh
npx cypress verify
exec "$@"

2. 确保Buildx的多架构模拟环境正常

先执行以下命令，确保QEMU的多架构模拟支持正确安装：

docker run --rm --privileged tonistiigi/binfmt --install all

然后重新创建并初始化buildx builder：

docker buildx create --use --name multi-arch-builder
docker buildx inspect multi-arch-builder --bootstrap

3. 分架构构建后合并（可选）

如果不想依赖QEMU模拟，可以分别在对应架构的机器上构建单架构镜像，再用Docker Manifest合并成多架构镜像：

• 在Intel Mac上构建amd64镜像：

  docker buildx build -t my-multi-arch-cypress-image:amd64 -f Dockerfile-cypress-arm . --platform linux/amd64 --push
  

• 在M1 Mac上构建arm64镜像：

  docker buildx build -t my-multi-arch-cypress-image:arm64 -f Dockerfile-cypress-arm . --platform linux/arm64 --push
  

• 合并成多架构镜像：

  docker manifest create my-multi-arch-cypress-image my-multi-arch-cypress-image:amd64 my-multi-arch-cypress-image:arm64
  docker manifest push my-multi-arch-cypress-image
  

验证 #

修改完成后，重新执行你的构建命令：

docker buildx build -t my-multi-arch-cypress-image -f Dockerfile-cypress-arm . --platform linux/amd64,linux/arm64 --push

构建完成后，M1和Intel机器都可以正常拉取镜像运行Cypress测试。

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