docker『Cannot Start Service』の原因と対処法

# 直近のエラーとイベント
docker compose ps
docker compose logs --no-color --tail=200 <service>
docker inspect <container_or_image> --format '{{json .State}}' | jq .

# 詳細デバッグ（Compose）
docker compose --verbose up <service>

# 単体で起動→ENTRYPOINT/CMD切り分け
docker compose run --rm --entrypoint sh <service>

# イメージのエントリ/コマンドを確認
docker image inspect <image>:<tag> --format '{{json .Config}}' | jq '.Entrypoint,.Cmd'

# exec形式CMDにする（シグナル伝播/引数処理が安定）
# docker-compose.yml（例）
services:
  app:
    image: node:20-alpine
    command: ["node","server.js"]   # ← exec形式
    # shell形式だと"/bin/sh -c ..."経由

# 実行権限不足で126 → 実行ビット付与して再ビルド
RUN chmod +x /usr/local/bin/start.sh

# 競合確認（Linux/macOS）
lsof -iTCP -sTCP:LISTEN -nP | grep :8080 || true

# Composeのポート定義を見直し
services:
  web:
    image: nginx
    ports:
      - "8080:80"   # ホスト8080が使用中なら他へ変更

# 典型：ソースが存在しない・権限不足で起動失敗
services:
  app:
    image: alpine
    volumes:
      - /abs/path/data:/app/data  # ソースは事前に mkdir -p で用意

# SELinuxがある場合は :z/:Z を付ける（RHEL系）
volumes:
  - /abs/path/data:/app/data:Z

# healthcheck と depends_on のconditionsで待つ
services:
  db:
    image: postgres:16
    healthcheck:
      test: ["CMD-SHELL","pg_isready -U postgres"]
      interval: 5s
      timeout: 3s
      retries: 10
  app:
    image: my/app:1.0
    depends_on:
      db:
        condition: service_healthy


# 外部依存に対しては起動時スクリプトで待機（例：wait-for-it.sh）
command: ["sh","-lc","./wait-for-it.sh db:5432 -- ./start.sh"]

# OOMKilledの有無
docker inspect <container> --format '{{json .State}}' | jq '.OOMKilled,.ExitCode'

# メモリ/スワップ制限を緩める
services:
  app:
    deploy:
      resources:
        limits:
          memory: 1g

# ulimit不足（ファイル数）を増やす例
services:
  app:
    ulimits:
      nofile:
        soft: 65536
        hard: 65536


# ディスク不足はまず掃除
docker system df -v
docker system prune -af --volumes

# 必須変数をComposeで明示&デフォルト
services:
  app:
    environment:
      - DB_HOST=${DB_HOST?set in .env}
      - DB_USER=${DB_USER:-app}

# 起動前チェック用エントリスクリプト（例）
#!/bin/sh
set -eu
: "${DB_HOST:?required}"
exec /usr/local/bin/app

# DNSサーバを明示（企業ネットワーク等）
services:
  app:
    dns:
      - 8.8.8.8
      - 1.1.1.1

# プロキシをアプリ/ベースイメージに合わせて設定
environment:
  - HTTP_PROXY=http://proxy:8080
  - NO_PROXY=localhost,127.0.0.1,db

# 実行ユーザーを固定し、必要なファイル権限を準備
services:
  app:
    user: "1000:1000"
    volumes:
      - /abs/path/data:/app/data

# 一部機能でcapが必要な場合（最小限で）
cap_add:
  - NET_ADMIN

# GPUコンテナの例（NVIDIA）
services:
  worker:
    image: nvidia/cuda:12.3.2-runtime-ubuntu22.04
    deploy:
      resources:
        reservations:
          devices:
            - capabilities: ["gpu"]

# デバイスマッピング
devices:
  - /dev/ttyUSB0:/dev/ttyUSB0

# バージョンと実装の差異を回避（compose-spec準拠）
docker compose version
docker compose config   # 展開後の最終形を検証

# DesktopのFile Sharingにホストパスを追加（macOS/Windows）
# WSL2は /mnt/c/... か Linux側/home配下のパスを使う
# WSL再起動で改善することも
wsl --shutdown

# 同じイメージをシェルで起動 → 依存欠落/権限/PATHを確認
docker run --rm -it --entrypoint sh <image> -lc '
  id && env | sort | sed -n "1,10p"
  which app || exit 127
  test -r /app/config.yml || exit 2
  app --version || exit 1
'

# NG: shell形式CMDでシグナル/引数問題 → OK: exec形式
CMD ["node","server.js"]

# NG: ポート競合 → OK: ホスト側ポート変更 or 競合プロセス停止
ports: ["18080:8080"]

# NG: バインド元が存在しない → OK: 事前作成 & SELinuxは :z/:Z
volumes: ["/abs/path/data:/app/data:Z"]

# NG: 依存DB起動待ちなし → OK: healthcheck + depends_on.condition
depends_on: { db: { condition: service_healthy } }

# NG: OOM/ulimit不足 → OK: memory/ulimit を増やす
ulimits: { nofile: { soft: 65536, hard: 65536 } }

# NG: 必須ENV不足 → OK: .env と required記法
environment: ["DB_HOST=${DB_HOST?set}"]