docker『Timeout Reached』の原因と対処法

# ホスト側からレジストリや外部サイトへの疎通を確認
ping -c 3 registry-1.docker.io || echo "ping NG"

# DNS 解決ができるか
nslookup registry-1.docker.io || dig registry-1.docker.io

# HTTPS ポート(443)に到達できるか
nc -vz registry-1.docker.io 443

# 詳細ログを有効にして pull する例
DOCKER_CLI_HINTS=false docker -D pull nginx:1.25

# プロキシ環境での設定例（Linux）
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
export NO_PROXY=localhost,127.0.0.1,registry.local
docker pull registry.local/myorg/app:1.0

# コンテナログでアプリの状況を確認
docker logs <container> --tail=200

# コンテナ内から自身のHTTPエンドポイントを叩いてみる
docker exec -it <container> sh -lc "curl -v http://127.0.0.1:8080/health || echo 'ng'"

# docker-compose.yml の healthcheck 例（タイムアウト緩和）
services:
  app:
    image: myorg/app:1.0
    healthcheck:
      test: ["CMD-SHELL", "curl -f http://localhost:8080/health || exit 1"]
      interval: 30s
      timeout: 5s
      retries: 5
      start_period: 40s

# Dockerfile 内での一時デバッグ：curl/wgetで疎通確認
RUN apk add --no-cache curl && \
    curl -v https://example.com/health || (echo "network NG" && exit 1)

# docker build にプロキシを渡す例
docker build \
  --build-arg HTTP_PROXY=http://proxy.example.com:8080 \
  --build-arg HTTPS_PROXY=http://proxy.example.com:8080 \
  -t myorg/app:build .

# Dockerfile
ARG HTTP_PROXY
ARG HTTPS_PROXY
ENV HTTP_PROXY=${HTTP_PROXY} HTTPS_PROXY=${HTTPS_PROXY}

# 例: GitHub Actions での timeout-minutes 設定
jobs:
  build:
    timeout-minutes: 30
    steps:
      - name: Build image
        run: docker build -t myorg/app:${GITHUB_SHA} .

# コンテナ内からターゲットへの疎通とポートを確認
docker exec -it app sh -lc "
  ping -c1 db || echo 'ping NG';
  nc -vz db 5432 || echo 'db port NG';
"

# 接続先を環境変数で管理する例
services:
  app:
    environment:
      - DB_HOST=db
      - DB_PORT=5432

# リソース状況を確認
docker stats --no-stream
iostat -xz 1 5 || vmstat 1 5

# コンテナに付与しているCPU/メモリ制限
docker inspect <container> \
  --format '{{json .HostConfig.NanoCpus}} {{json .HostConfig.Memory}}'

// Node.js axios の例
const axiosInstance = axios.create({
  timeout: 10000, // 10秒
});

// Go http.Client の例
client := &http.Client{
  Timeout: 10 * time.Second,
}

# 1) コンテナ内から外部に出られるか
docker exec -it <container> sh -lc "
  echo '--- ping google ---';
  ping -c1 8.8.8.8 || echo 'ping NG';
  echo '--- DNS ---';
  nslookup google.com || echo 'dns NG';
"

# 2) レジストリへのHTTP(S)疎通
curl -v https://registry-1.docker.io/v2/ || echo 'registry NG'

# 3) アプリの内部ヘルスエンドポイント
docker exec -it <container> sh -lc "curl -v http://localhost:8080/health || echo 'health NG'"

# 1) docker pull が毎回タイムアウト
# NG: プロキシ/Firewall設定なしで企業ネットワークから直接pull
docker pull nginx:latest

# OK: プロキシやNO_PROXYを正しく設定
export HTTPS_PROXY=http://proxy:8080
export NO_PROXY=localhost,127.0.0.1,registry.local
docker pull registry.local/myorg/app:1.0

# 2) healthcheck が短すぎて起動が間に合わない
# NG:
healthcheck:
  test: ["CMD","curl","-f","http://localhost:8080/health"]
  interval: 5s
  timeout: 2s
  retries: 2

# OK:
healthcheck:
  test: ["CMD-SHELL","curl -f http://localhost:8080/health || exit 1"]
  interval: 30s
  timeout: 5s
  retries: 5
  start_period: 40s

# 3) docker build 中に apt がタイムアウト
# NG:
RUN apt-get update && apt-get install -y build-essential

# OK: 近いミラーを使う・リトライを入れる・プロキシ設定を渡す
RUN sed -i 's|archive.ubuntu.com|jp.archive.ubuntu.com|g' /etc/apt/sources.list && \
    apt-get update && \
    apt-get install -y build-essential

# 4) コンテナ間通信でDNS名ミス→タイムアウト
# NG:
DATABASE_URL=postgres://user:pass@localhost:5432/app  # コンテナ内でlocalhost

# OK:
DATABASE_URL=postgres://user:pass@db:5432/app        # サービス名を指定