dockerize-and-deploy

Docker 化とデプロイ

リポジトリをコンテナ化し、デプロイ環境をフェーズごとに構築します。

ワークフロー

1. 監査

ランタイム、サービス、データストア、ビルド手順、既存の Docker ファイル、環境変数を特定します。ファイルを作成する前にフェーズを提案します。

2. フェーズ

1. Dockerfile — マルチステージ構成にします。ビルダーでインストールとコンパイルを行い、ランタイムには成果物のみをコピーします。非 root ユーザーを使用し、バージョンを固定したベースイメージ（例：node:20.11-alpine）を指定します。.dockerignore で node_modules／.env／.git を除外します。
2. docker-compose — 開発用スタックを構成します。ホットリロード用のソースマウント、デバッグポート、名前付きボリュームを設定します。
3. 本番用 compose（docker-compose.prod.yml）— ソースマウントを使用せず、restart: unless-stopped、ヘルスチェック、明示的なボリューム、mem_limit／cpus の制限を設定します。REFERENCE.md を参照してください。
4. 事前チェック — scripts/preflight.sh をプロジェクトにコピーします。環境変数、Docker、ポートの競合、DB への到達性、ビルドのドライランを検証します。実行方法：bash scripts/preflight.sh。
5. デプロイ — scripts/deploy.sh：preflight.sh を実行（失敗時は中止）→ イメージをプル／ビルド → マイグレーションを実行 → ローリング再起動 → ヘルスチェック → 状態を出力。

シンプルなリポジトリでは、フェーズを統合またはスキップします。

3. 各フェーズの後に検証

docker build -t app:test .           # Dockerfile compiles
docker compose config                # compose files are valid YAML
docker compose up -d && docker compose ps  # services start healthy
bash scripts/preflight.sh            # pre-flight passes

ガードレール

• Docker／compose ファイルにシークレットを埋め込まないでください。
• コンテナは必ず非 root ユーザーで実行してください。
• 本番環境では latest イメージタグを使用せず、バージョンを固定してください。
• DB ボリュームには名前付きボリュームのみを使用し、ホストのバインドマウントは使用しないでください。
• .env.example がない場合は、まず作成してください。

参考資料

• REFERENCE.md — ボリューム／ヘルスチェックのパターン、リソース制限、ランタイム別のマルチステージ構成例、ローリングデプロイ戦略。