Dev Container

Dev Container とは

Dev Container (Development Container) は、Docker コンテナ内に開発環境を定義し、.devcontainer/devcontainer.json でツール、拡張機能、設定を宣言的に管理する仕組みである。「自分の環境では動く」問題を解消し、チーム全員が同一の環境で開発できる。

なぜ必要か

開発チームでは、メンバーごとに Node.js のバージョンや OS が異なり、「自分の環境では動く」問題が頻発する。Dev Container を使えば、Docker コンテナ内に統一された開発環境を定義でき、新メンバーも設定ファイル 1 つで即座に開発を開始できる。

問題	Dev Container での解決
Node.js のバージョンが人によって違う	コンテナで統一
OS 依存のバグ (macOS vs Linux)	Linux コンテナで統一
新メンバーの環境構築に半日かかる	devcontainer.json で自動化
ローカル環境を汚したくない	コンテナ内で完結

設定ファイル

設定ファイルの例を示す。

// .devcontainer/devcontainer.json
{
  "name": "My Project",
  "image": "mcr.microsoft.com/devcontainers/typescript-node:22",
  "features": {
    "ghcr.io/devcontainers/features/aws-cli:1": {},
    "ghcr.io/devcontainers/features/docker-in-docker:2": {}
  },
  "customizations": {
    "vscode": {
      "extensions": [
        "dbaeumer.vscode-eslint",
        "esbenp.prettier-vscode"
      ],
      "settings": {
        "editor.formatOnSave": true
      }
    }
  },
  "postCreateCommand": "npm ci",
  "forwardPorts": [3000]
}

Docker Compose との統合

Docker Compose との 統合の例を示す。

{
  "dockerComposeFile": "docker-compose.yml",
  "service": "app",
  "workspaceFolder": "/workspace"
}

# docker-compose.yml
services:
  app:
    build: .
    volumes:
      - .:/workspace
  db:
    image: postgres:16
    environment:
      POSTGRES_PASSWORD: dev

Features

Dev Container Features で追加ツールを宣言的にインストールする。

Feature	説明
aws-cli	AWS CLI
docker-in-docker	コンテナ内で Docker を使用
node	Node.js
python	Python
terraform	Terraform

GitHub Codespaces

GitHub Codespaces は Dev Container をクラウドで実行する。ブラウザから VS Code を開き、ローカルに何もインストールせずに開発を開始できる。

ローカル開発との比較

ローカル開発との主な違いを以下に比較する。

観点	ローカル開発	Dev Container
環境構築	手動 (README に従う)	自動 (devcontainer.json)
再現性	低い (環境差異)	高い (コンテナで統一)
パフォーマンス	高い (ネイティブ)	やや低い (コンテナオーバーヘッド)
ファイル I/O	高速	macOS では遅い場合がある

Dev Container の背景や設計思想は関連書籍に詳しい。