M1 Mac构建Docker镜像部署K3s Pod报exec format error如何解决

exec /bin/bash: exec format error 报错的核心原因是容器内二进制文件的指令集架构与节点CPU架构不匹配，你的初步判断完全准确。
搭载M1芯片的Mac设备为ARM64（aarch64）架构，默认执行docker build构建出的容器镜像为ARM64架构；常规规格的Digital Ocean Droplet云服务器为x86_64（amd64）架构，x86架构的系统内核无法识别、执行ARM指令集编译的bash二进制文件，因此抛出该格式错误。

执行以下命令可明确确认问题，排除其他干扰项：

• 登录K3s集群所在的Ubuntu节点，执行uname -m，返回结果为x86_64即可确认节点为amd64架构；
• 在本地M1 Mac上执行docker image inspect pitosalas/rails-image | grep Architecture，返回结果为arm64即可确认镜像为ARM架构，与节点架构不匹配。

注：若架构匹配仍出现同类报错，可再排查Dockerfile中CMD指定的二进制路径是否存在、是否配置了可执行权限，当前场景无需做该项检查。

以下两种方案任选其一即可：

方案1：本地跨架构构建适配amd64节点的镜像 #

Docker Desktop默认自带buildx组件，支持在ARM设备上直接构建x86架构的镜像，操作步骤如下：

1. 执行以下命令直接构建amd64架构镜像并推送到Docker Hub，该命令会自动完成构建、标记、推送全流程，无需单独执行tag、push操作：

   docker buildx build --platform linux/amd64 -t pitosalas/rails-image --push .
   

2. 删除之前创建的异常Pod，重新执行kubectl apply -f rails-pod.yaml完成部署即可。

方案2：在集群节点本地构建镜像 #

将Dockerfile上传到Ubuntu节点，在节点本地执行镜像构建，本地构建的镜像天然匹配节点架构：

1. 在节点对应目录执行构建命令：

   docker build -t pitosalas/rails-image .
   

2. 修改rails-pod.yaml的容器配置段，添加imagePullPolicy: IfNotPresent字段，避免K3s从远程仓库拉取旧的ARM架构镜像覆盖本地构建的版本；
3. 重新执行apply命令部署Pod即可。

当前配置存在一处端口不匹配问题，后续启动Rails服务时需要修正：

• Dockerfile中声明暴露的服务端口为3000，但Pod配置中containerPort写的是8080，需要将两处端口统一，否则会出现服务无法访问的问题。

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