docker initコマンド完全ガイド:ベストプラクティスに準拠したDockerfileとComposeを自動生成

Docker tutorial - IT technology blog
Docker tutorial - IT technology blog

クイックスタート:数分でDocker設定を初期化する

新しいリポジトリをコンテナ化する際、皆さんはどうしていますか?過去のプロジェクトを探し出し、Dockerfileをコピーして、ポート番号やコマンドを手動で修正していませんか?このやり方は時間がかかるだけでなく、不要な設定ゴミを持ち込みがちです。Docker Desktop 4.18(Docker CLI v23.0)以降、Dockerにはこうした面倒な初期設定を一括で解決してくれるdocker initコマンドが標準搭載されています。

プロジェクトのルートディレクトリに移動し、コマンドを1つ実行するだけです:

cd /path/to/my-project
docker init

ターミナル上に対話型(インタラクティブ)のUIが表示され、プロジェクトの技術スタックについていくつか質問されます:

? What application platform does your project use?  [Use arrows to move, type to filter]
  Go
> Node
  Python
  Rust
  ASP.NET Core
  Java
  Other

ウィザードでは、以下の5つの項目を順に確認していきます:

  1. Application platform: プロジェクトの言語・プラットフォーム(Node、Python、Go、Java、Rustなど)。
  2. Version: ランタイムのバージョン(Node 20.11やPython 3.11など)。
  3. Package manager: パッケージマネージャー(npm、yarn、pnpmなど)。
  4. Entrypoint command: アプリケーションの起動コマンド(npm start、python manage.py runserver、uvicorn main:appなど)。
  5. Port: サービスがリッスンするポート番号(例:3000、8000)。

選択肢を30秒ほど選んでいくだけで、ルートディレクトリに以下の4つのファイルが自動生成されます:

  • Dockerfile:マルチステージビルド、キャッシュマウント、非rootユーザーがあらかじめ設定済み。
  • compose.yaml:ポートマッピング、環境変数、ボリュームが構成済みのComposeファイル。
  • .dockerignore:node_modules、.git、ログファイルなどの不要なファイルを適切に除外。
  • README.Docker.md:サービスのビルド、実行、デバッグ方法をまとめた詳細なチートシート。

実際にコンテナ群を起動してみましょう:

docker compose up --build -d
docker compose logs -f

これだけでアプリケーションが綺麗にコンテナ内で動作します。全体の所要時間は2分未満で、設定構文を1行も手書きする必要はありません。

docker initが生成するファイルの中身を徹底解説

手軽さはもちろんのこと、docker initの最大の価値は、手作業では見落とされがちな「ベストプラクティス」を極めて厳格に適用してくれる点にあります。

1. Dockerfile:キャッシュの最適化とセキュリティの強化

以下は、ツールが自動生成したNode.jsプロジェクト向けのDockerfileです:

# syntax=docker/dockerfile:1

ARG NODE_VERSION=20.11.0
FROM node:${NODE_VERSION}-alpine as base
WORKDIR /usr/src/app
EXPOSE 3000

FROM base as deps
RUN --mount=type=bind,source=package.json,target=package.json \
    --mount=type=bind,source=package-lock.json,target=package-lock.json \
    --mount=type=cache,target=/root/.npm \
    npm ci --omit=dev

FROM deps as final
USER node
COPY package.json .
COPY --from=deps /usr/src/app/node_modules ./node_modules
COPY . .
CMD npm start

ここで注目すべき、非常に価値の高い3つの技術的ポイントがあります:

  • BuildKitキャッシュマウント(--mount=type=cache):npmやpipのキャッシュをホスト側のエンジンに直接保持します。JavaScriptファイルを1行修正した程度であれば、パッケージを一から再取得する必要がありません。ビルド時間を2〜3分からわずか数秒にまで大幅に短縮できます。
  • 非rootユーザー(USER node):プロセスをroot権限で実行しません。仮にアプリケーションにリモートコード実行(RCE)の脆弱性があっても、攻撃者が権限昇格を行ってホストサーバーを乗っ取るリスクを最小限に抑えられます。
  • Alpineベースイメージ:800MB〜1GBもある肥大化したUbuntu/Debianイメージをプルする代わりに、約50MBに軽量化されたAlpineイメージを採用することで、ディスク消費を抑え、アタックサーフェス(攻撃対象領域)を縮小します。

2. docker-compose.ymlに代わる標準のcompose.yamlを採用

新しく生成されるComposeファイルの名前は標準のcompose.yamlとなっています。これはDocker Compose仕様(Compose Specification)の公式な標準命名規約です。

services:
  server:
    build:
      context: .
    ports:
      - 3000:3000
    environment:
      - NODE_ENV=production

ファイル先頭にあったversion: '3.8'の記述がなくなっていることにお気づきでしょうか。もし現在もこの記述を書いているなら、それは不要な作業です。Compose v2ではこのフィールドは既に非推奨となり、無視されるようになっています。

3. .dockerignoreファイル:ビルドコンテキストのクリーン化

ローカル環境の400MB以上もあるnode_modulesを誤ってDockerデーモンに転送してしまうことは、ビルドが極端に遅くなる最大の原因です。さらに深刻なのは、本番環境のシークレット情報を含む.envファイルがイメージに紛れ込んでしまうセキュリティ事故です。docker initは、各フレームワークに最適化された詳細な除外リストを自動で定義してくれます。

応用:競合状態(Race Condition)を回避するデータベース連携

ウィザード実行時、アプリケーションでデータベースを使用するか尋ねられます。PostgreSQLやMySQLを選択すると、Dockerは永続化ボリュームやセキュアなSecret管理の設定とともに、DBサービスをcompose.yamlに自動で組み込んでくれます。

PostgreSQLを組み込んだ完全な構成ファイルの例は以下のとおりです:

services:
  server:
    build:
      context: .
    ports:
      - 8000:8000
    depends_on:
      db:
        condition: service_healthy
    environment:
      - POSTGRES_HOST=db
      - POSTGRES_PASSWORD_FILE=/run/secrets/db-password
    secrets:
      - db-password

  db:
    image: postgres:16-alpine
    restart: unless-stopped
    user: postgres
    secrets:
      - db-password
    environment:
      - POSTGRES_PASSWORD_FILE=/run/secrets/db-password
      - POSTGRES_USER=postgres
      - POSTGRES_DB=app_db
    volumes:
      - db-data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD", "pg_isready"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  db-data:

secrets:
  db-password:
    file: db/password.txt

非常にスマートな設計となっているのが、condition: service_healthyとPostgreSQLの<a href="https://itfromzero.com/ja/docker-ja/docker-autoheal%e5%85%a5%e9%96%80%ef%bc%9a%e3%82%b3%e3%83%b3%e3%83%86%e3%83%8a%e3%81%8cunhealthy%e3%81%ab%e3%81%aa%e3%81%a3%e3%81%9f%e9%9a%9b%e3%81%ab%e8%87%aa%e5%8b%95%e5%86%8d%e8%b5%b7%e5%8b%95.html">healthcheck</a>(pg_isreadyコマンド)の連携です。Webサービスはデータベースが接続受付可能な状態になるまで待機してから起動するため、競合状態(Race Condition)によるクラッシュを防ぐために面倒なwait-for-it.shスクリプトを書く必要はもうありません。

実務で役立つdocker init運用のベストプラクティス

日々の開発ワークフローにこのコマンドを導入する際は、以下の4つのポイントを押さえておくとスムーズです:

  • 実行前に必ずコードをコミットしておく:ディレクトリに既存のDockerfileやcompose.yamlが存在する場合、上書きの確認を求められます。あらかじめgit commitするか新規ブランチを切っておけば、差分確認(diff)やロールバックが容易になり安心です。
  • 未対応スタック向けのテンプレートとして活用する:Elixir、PHP、Rubyなど、ウィザードに直接項目がない言語の場合はどうすればよいでしょうか?その際はOtherを選択するか、PythonやNodeのテンプレートを流用して、マルチステージ構成やボリュームの標準的な記述をベースにカスタマイズするのがおすすめです。
  • BuildKitを無効化しない:# syntax=docker/dockerfile:1という構文宣言や--mount=type=cacheフラグは、BuildKitが有効であることを前提としています。Docker CLIのデフォルト設定(v23.0以降はデフォルトで有効)のまま運用しましょう。
  • シークレットファイルの管理を徹底する:安全にパスワードをマウントするために生成されたdb/password.txtファイルは、データベースのパスワードをGitHub等に誤ってプッシュしないよう、直ちに.gitignoreへ追加してください。

ネット上に転がっている設定ファイルを寄せ集めるのに貴重な時間を費やすのはやめましょう。ターミナルでdocker initを実行し、プロジェクトの初日からセキュアで最適化された完成度の高いコンテナ環境を手に入れましょう。

Share: