Tasuke Hubのロゴ

ITを中心に困っている人を助けるメディア

分かりやすく解決策を提供することで、あなたの困ったをサポート。 全ての人々がスムーズに生活できる世界を目指します。

  1. ホーム
  2. Docker
  3. 【初心者向け】Dockerで開発環境を簡単構築！ウェブ開発のトラブルを一発解決

【初心者向け】Dockerで開発環境を簡単構築！ウェブ開発のトラブルを一発解決

時計のアイコン4 May, 2025
記事のサムネイル

「環境構築に苦労した経験はありませんか？」Dockerとは何か

「ローカルでは動くのに、他の環境では動かない…」というフレーズはプログラマーの間で有名な悩みです。環境構築の問題はウェブ開発において大きな時間の浪費となります。そんな悩みを解決するのがDockerです。

Dockerとは、アプリケーションとその実行に必要な環境を一緒に「コンテナ」として管理するプラットフォームです。コンテナとは、独立した実行環境で、必要なすべての依存関係（ライブラリ、設定など）を含んでいます。これにより、異なるマシンや環境で一貫した動作を保証します。

目次

TH

Tasuke Hub管理人

東証プライム市場上場企業エンジニア

情報系修士卒業後、大手IT企業にてフルスタックエンジニアとして活躍。 Webアプリケーション開発からクラウドインフラ構築まで幅広い技術に精通し、 複数のプロジェクトでリードエンジニアを担当。 技術ブログやオープンソースへの貢献を通じて、日本のIT技術コミュニティに積極的に関わっている。

🎓情報系修士🏢東証プライム上場企業💻フルスタックエンジニア📝技術ブログ執筆者

Dockerの主な特徴は以下の通りです：

  • 移植性: 「開発環境で動くけど本番環境で動かない」という問題を解消
  • 軽量: 仮想マシンよりも少ないリソースで動作
  • 迅速な起動: コンテナは数秒で起動可能
  • 効率的な開発: 環境構築の手間を大幅に削減

例えば、Node.jsアプリケーションを開発している場合、Dockerを使えば、Node.jsの特定のバージョンや必要なライブラリをすべて含んだコンテナを作成できます。これにより、チームの全員が同じ環境で開発でき、環境の違いによるトラブルを防ぐことができます。

アインシュタインの名言「同じことを繰り返しながら異なる結果を期待するのは狂気の証だ」という言葉がありますが、開発環境の不一致はまさにその状況を生み出します。Dockerはこの「狂気」から私たちを救ってくれるツールなのです。

Dockerの基本概念：イメージとコンテナの違い

関連記事

Dockerを使いこなすには、基本的な概念をしっかり理解することが重要です。特に「イメージ」と「コンテナ」の違いは多くの初心者が混乱しがちな点です。

Dockerイメージとは

あわせて読みたい

Dockerイメージは、アプリケーションとその実行に必要なすべての要素（コード、ランタイム、ライブラリ、環境変数、設定ファイルなど）を含む読み取り専用のテンプレートです。料理に例えると、イメージはレシピのようなものです。

イメージの特徴：

  • 読み取り専用
  • 階層構造を持つ
  • 再利用可能
  • DockerHubなどのレジストリに保存・共有可能

Dockerコンテナとは

コンテナは、イメージから作成された実行インスタンスです。料理の例を続けると、コンテナはレシピ（イメージ）から作った実際の料理です。

コンテナの特徴：

  • イメージの実行可能なインスタンス
  • 独立した環境で動作
  • 複数のコンテナを同時に実行可能
  • 作成、起動、停止、削除が可能

この関係を理解するために、具体的なコマンド例を見てみましょう：

# Dockerイメージをビルド
docker build -t my-web-app .

# イメージからコンテナを作成して実行
docker run -p 3000:3000 my-web-app

上記の例では、まずdocker buildコマンドでアプリケーションのイメージを作成し、次にdocker runコマンドでそのイメージからコンテナを起動しています。

「失敗は成功のもと」という言葉がありますが、Dockerの世界では「イメージは成功のもと」と言えるでしょう。確かなイメージがあれば、どこでも同じように動作するコンテナを生み出すことができるのです。

初めてのDockerfile：Webアプリ開発のための基本構成

Dockerfileは、Dockerイメージを作成するための指示書です。テキストファイルですが、その中に書かれる命令によって、どのようなイメージが作られるかが決まります。ここでは、Webアプリケーション用のシンプルなDockerfileを作成してみましょう。

基本的なDockerfileの構造

まず、基本的なNode.jsアプリケーション用のDockerfileを見てみましょう：

# ベースイメージの指定
FROM node:18-alpine

# 作業ディレクトリの設定
WORKDIR /app

# パッケージファイルのコピー
COPY package*.json ./

# 依存関係のインストール
RUN npm install

# アプリケーションのソースコードをコピー
COPY . .

# ポートの公開
EXPOSE 3000

# アプリケーションの起動コマンド
CMD ["npm", "start"]

各命令の説明

  1. FROM: ベースイメージを指定します。ここでは軽量なAlpineベースのNode.js 18を使用しています。
  2. WORKDIR: コンテナ内の作業ディレクトリを設定します。
  3. COPY package.json ./*: パッケージファイルだけを先にコピーします（キャッシュ最適化のため）。
  4. RUN: イメージビルド時に実行するコマンドを指定します。ここでは依存関係をインストールしています。
  5. COPY . .: アプリケーションのソースコードをコピーします。
  6. EXPOSE: コンテナが公開するポートを指定します。
  7. CMD: コンテナ起動時に実行するコマンドを指定します。

Webアプリケーション別の設定例

異なるWebアプリケーションフレームワーク向けのDockerfile設定例も押さえておきましょう：

Reactアプリケーション用

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
RUN npm run build
EXPOSE 3000
CMD ["npm", "run", "serve"]

Pythonの Flask/Django用

FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
EXPOSE 5000
CMD ["python", "app.py"]

「シンプルさは究極の洗練である」という言葉がありますが、Dockerfileもまさにそうです。複雑にするのではなく、必要最小限の指示で明確に目的を達成することが重要です。初めは基本構成を理解し、徐々に最適化していくアプローチが効果的でしょう。

Docker Composeで複数コンテナを連携：フルスタックアプリの構築

現代のウェブアプリケーションは、フロントエンド、バックエンド、データベースなど複数のコンポーネントから構成されることが一般的です。Docker Composeを使うと、これらの複数のコンテナを簡単に定義し、一緒に管理することができます。

Docker Composeとは

Docker Composeは、複数のコンテナを定義し実行するためのツールです。YAML形式の設定ファイル（docker-compose.yml）に、アプリケーションのサービス、ネットワーク、ボリュームなどを定義します。

基本的なdocker-compose.ymlの例

一般的なWebアプリケーション（フロントエンド、バックエンド、データベース）の構成例を見てみましょう：

version: '3'
services:
  # フロントエンド（Reactアプリケーション）
  frontend:
    build: ./frontend
    ports:
      - "3000:3000"
    volumes:
      - ./frontend:/app
      - /app/node_modules
    depends_on:
      - backend

  # バックエンド（Node.jsサーバー）
  backend:
    build: ./backend
    ports:
      - "5000:5000"
    volumes:
      - ./backend:/app
      - /app/node_modules
    environment:
      - DB_HOST=database
      - DB_USER=postgres
      - DB_PASSWORD=password
      - DB_NAME=myapp
    depends_on:
      - database

  # データベース（PostgreSQL）
  database:
    image: postgres:14
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data
    environment:
      - POSTGRES_PASSWORD=password
      - POSTGRES_USER=postgres
      - POSTGRES_DB=myapp

volumes:
  postgres_data:

Docker Composeの主要コマンド

Docker Composeを使う際の基本的なコマンドは以下の通りです：

# サービスを起動（バックグラウンドで実行）
docker-compose up -d

# サービスの状態を確認
docker-compose ps

# サービスのログを表示
docker-compose logs

# 特定のサービスのログを表示
docker-compose logs backend

# サービスを停止
docker-compose down

# サービスを停止し、ボリュームも削除
docker-compose down -v

開発環境と本番環境の設定分け

開発環境と本番環境で異なる設定を使用したい場合は、複数の設定ファイルを作成することができます：

  • docker-compose.yml - 基本設定
  • docker-compose.override.yml - 開発環境用の設定（デフォルトで読み込まれる）
  • docker-compose.prod.yml - 本番環境用の設定

本番環境で使用する場合は、以下のようにコマンドを実行します：

docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d

「一輪の花より一束の花の方が美しい」という言葉があります。Docker Composeを使えば、個々のコンテナの美しさを維持しながら、それらを協調させて、より強力なアプリケーション環境を作り出すことができるのです。

開発効率を上げるDockerの実践テクニック

Dockerを基本的に使いこなせるようになったら、次は開発効率を向上させるテクニックを学びましょう。これらの実践的なテクニックを身につけることで、日々の開発作業がよりスムーズになります。

ホットリロード対応の開発環境設定

コードを変更するたびにコンテナを再起動するのは非効率です。ボリュームマウントとホットリロード機能を活用しましょう：

services:
  webapp:
    build: .
    ports:
      - "3000:3000"
    volumes:
      - .:/app
      - /app/node_modules
    environment:
      - NODE_ENV=development
    command: npm run dev  # ホットリロード対応のコマンド

効率的なDockerイメージ構築テクニック

ビルド時間を短縮し、イメージサイズを小さくするためのテクニックを見ていきましょう：

  1. マルチステージビルド
# ビルドステージ
FROM node:18 AS build
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
RUN npm run build

# 実行ステージ
FROM nginx:alpine
COPY --from=build /app/build /usr/share/nginx/html
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]
  1. キャッシュの最適化

変更が少ない部分を先にコピーして、キャッシュを効率的に活用します：

COPY package*.json ./
RUN npm install
# その後でソースコードをコピー
COPY . .
  1. .dockerignoreファイルの活用

不要なファイルがイメージに含まれないようにします：

node_modules
npm-debug.log
Dockerfile
.dockerignore
.git
.github

デバッグとトラブルシューティング

開発中に問題が発生した場合のデバッグテクニックを押さえておきましょう：

  1. コンテナ内でコマンド実行
# 実行中のコンテナ内でシェルを起動
docker exec -it container_name /bin/sh

# 特定のコマンドを実行
docker exec container_name npm list
  1. ログの確認
# コンテナのログを表示
docker logs container_name

# ログを継続的に表示
docker logs -f container_name
  1. コンテナの詳細情報を確認
docker inspect container_name

「急がば回れ」という言葉がありますが、開発効率を上げるためには、一見遠回りに見えるこれらのテクニックを習得することが実は近道なのです。適切なツールとテクニックを使って開発環境を最適化することで、長期的には大幅な時間短縮につながります。

Docker活用のベストプラクティスと注意点

Dockerを効果的に活用するには、ベストプラクティスを押さえておくことが重要です。また、よくある落とし穴を避けるための注意点も知っておきましょう。これらの知識は、実際のプロジェクトでDockerを使う際に大いに役立ちます。

セキュリティのベストプラクティス

  1. 最小権限の原則を守る

コンテナ内では必要最低限の権限だけを与えるようにしましょう：

# ルートユーザーではなく専用ユーザーを作成
RUN addgroup -S appgroup && adduser -S appuser -G appgroup
USER appuser
  1. 機密情報の取り扱い

パスワードやAPIキーなどをイメージ内に直接埋め込まないようにします：

# docker-compose.ymlでの環境変数の扱い
services:
  app:
    environment:
      - DB_PASSWORD=${DB_PASSWORD}
  1. イメージの脆弱性スキャン
# Docker Scanを使用した脆弱性スキャン
docker scan myimage:latest

パフォーマンス最適化

  1. イメージサイズの削減

不要なファイルを含めない、最小の基本イメージを選ぶなどの工夫をしましょう：

# Alpine版を使用して軽量化
FROM node:18-alpine

# 一時ファイルを削除
RUN npm install && npm cache clean --force
  1. ビルドコンテキストの最適化

.dockerignoreファイルを適切に設定し、不要なファイルがビルドコンテキストに含まれないようにします。

  1. レイヤーの最適化

関連するコマンドをグループ化して、レイヤー数を減らします：

# 良い例
RUN apt-get update && \
    apt-get install -y package1 package2 && \
    apt-get clean && \
    rm -rf /var/lib/apt/lists/*

よくある落とし穴と対処法

  1. ボリュームとパーミッションの問題

ホスト側とコンテナ側でのユーザーIDが異なると、パーミッションの問題が発生することがあります：

# volumesの設定でパーミッションに注意
volumes:
  - ./data:/app/data:z
  1. ネットワーク接続の問題

コンテナ間で通信する際に、適切なネットワーク設定が必要です：

# 明示的にネットワークを定義する
networks:
  app_network:
    driver: bridge

services:
  app:
    networks:
      - app_network
  1. リソース制限の設定

コンテナがホストのリソースを使い果たさないように制限を設定することも大切です：

services:
  app:
    deploy:
      resources:
        limits:
          cpus: '0.5'
          memory: 512M

「痛みなくして得るものなし」というように、Docker活用の道のりには多少の困難が伴うこともあります。しかし、これらのベストプラクティスと注意点を押さえておくことで、多くの問題を事前に回避し、スムーズな開発環境を維持することができるでしょう。

おすすめ記事

おすすめコンテンツ