docker『Exec Format Error』の原因と対処法

# 典型メッセージ（コンテナ起動時/exec時）
standard_init_linux.go:xxx: exec user process caused: exec format error
exec /usr/local/bin/start.sh: exec format error
[8] System error: exec format error

# ホスト/VMのアーキ
uname -m            # x86_64, aarch64 など

# イメージとプラットフォームの関係
docker image inspect <image>:<tag> --format '{{.Architecture}}'
docker buildx imagetools inspect <image>:<tag>  # multi-arch manifestの有無

# ENTRYPOINT/CMDの実体と権限
docker image inspect <image>:<tag> --format '{{json .Config}}' | jq '.Entrypoint,.Cmd'
docker run --rm -it --entrypoint sh <image>:<tag> -lc 'ls -l /usr/local/bin && file /usr/local/bin/* | head'

# その場しのぎ：ホストに合わせてpull/run
docker run --platform=$(uname -m | sed 's/x86_64/linux\/amd64/;s/aarch64/linux\/arm64/') <image>:<tag>

# エミュレーション（QEMU/binfmt）を整える
docker run --privileged --rm tonistiigi/binfmt --install all

# 正攻法：multi-archイメージをビルド＆配信
docker buildx create --use
docker buildx build --platform linux/amd64,linux/arm64 -t repo/app:1.2.3 --push .

# Alpine等は bash 非搭載が普通。shebangを /bin/sh に変更するか bash を導入
# 1) ベースに合わせて shebang を修正
#!/bin/sh
# 2) どうしても bash が必要なら導入
RUN apk add --no-cache bash

# スクリプトの改行/BOM/実行ビットを統一（Dockerfile）
FROM alpine:3.20
RUN apk add --no-cache dos2unix
COPY entrypoint.sh /usr/local/bin/entrypoint.sh
RUN dos2unix /usr/local/bin/entrypoint.sh \
 && sed -i '1s/^\xEF\xBB\xBF//' /usr/local/bin/entrypoint.sh \
 && chmod +x /usr/local/bin/entrypoint.sh
ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]

# NG（shell形式。改行/引用/環境で壊れやすい）
CMD npm start
# OK（exec形式。カーネルが直接実行）
CMD ["npm","start"]

# ENTRYPOINTも同様にexec形式を推奨
ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]

# バイナリのヘッダを確認
docker run --rm -v "$PWD:/w" alpine sh -lc 'apk add --no-cache file >/dev/null; file /w/app'
# 例: ELF 64-bit LSB executable, x86-64 ... → arm64ホストではエミュレーション/再ビルドが必要

# Goなどのクロスコンパイルで正しいターゲットへ
GOOS=linux GOARCH=arm64 go build -o app-arm64 .

# ENTRYPOINT/CMDがディレクトリを指していないか／存在するか
docker run --rm <image> sh -lc 'test -f /usr/local/bin/start || { ls -l /usr/local/bin; exit 1; }'

# CIのテストジョブ例：Linux用でない実行物をfailさせる
find . -type f -perm -0100 -exec file {} \; | \
  grep -E 'PE32|Mach-O' && { echo "Non-Linux binary found"; exit 1; } || true

# ノードのアーキを一覧し、スケジューリング先を確認
kubectl get nodes -o wide
# マニフェスト側で正しいイメージ/マニフェストを参照（multi-arch推奨）
kubectl set image deploy/app app=repo/app:1.2.3

# 1) 同イメージをシェルで起動し、実行ファイルの内容を確認
docker run --rm -it --entrypoint sh <image>:<tag> -lc '
  set -e
  which app || { echo "app not found"; exit 127; }
  file $(which app)
  head -c 3 /usr/local/bin/entrypoint.sh | od -An -tx1  # BOM検査
  ls -l /usr/local/bin/entrypoint.sh
'

# 2) --platform指定で動作差分を切り分け
docker run --rm --platform=linux/amd64 <image>:<tag> true
docker run --rm --platform=linux/arm64 <image>:<tag> true

# NG: arm64ホストにamd64単体イメージ → OK: --platform or multi-arch配布
docker run --platform=linux/arm64 <image>
docker buildx build --platform linux/amd64,linux/arm64 ...

# NG: #!/bin/bash（未導入） → OK: /usr/bin/env bash または /bin/sh に変更
#!/usr/bin/env bash

# NG: CRLF/BOM → OK: dos2unix + BOM除去 + chmod +x
RUN dos2unix /usr/local/bin/entrypoint.sh && sed -i "1s/^\xEF\xBB\xBF//" /usr/local/bin/entrypoint.sh && chmod +x /usr/local/bin/entrypoint.sh

# NG: shell形式CMD → OK: exec形式CMD/ENTRYPOINT
CMD ["node","server.js"]

# NG: 実体がMac/Winバイナリ → OK: Linux向けに再ビルド or multi-arch提供
GOOS=linux GOARCH=amd64 go build ./...