shibomb

DockerとComposeで環境依存を断つ！「動く」を保証する開発ワークフロー

新しいプロジェクトに参加したら、環境構築だけで半日以上が過ぎてしまった…。自分のパソコンでは動くのに、同僚の環境ではなぜかエラーが出る…。こんな経験、ありませんか？開発者なら誰しもが一度は直面するこれらの問題は、実は個人のスキル不足ではなく、開発環境そのものの「ズレ」が原因であることがほとんどです。この記事では、そんな開発環境にまつわる「モヤモヤ」を根本から解決する技術、Docker を紹介します。Dockerfileという「設計図」をもとに、誰でもどこでも同じ環境を再現できるDockerの世界へ、さあ一緒に飛び込んでみましょう！

はじめに：あなたの開発環境、こんな「モヤモヤ」ありませんか？

プログラミングの学習や実務において、私たちはコードを書く時間と同じくらい、あるいはそれ以上に「環境」と向き合う時間を費やしているかもしれません。

  • 「私のPCだと動くのに…」問題: OS (macOS, Windows, Linux) の違いや、インストールされているライブラリのバージョンの微妙な差異が原因で、チームメンバー間で挙動が変わってしまう。
  • 依存関係の地獄: プロジェクトAではPython 3.9が必要なのに、プロジェクトBではPython 3.11が必須。バージョン管理ツールを使っても、切り替えが煩雑だったり、システム全体に影響が出ないか不安になったりする。
  • 長すぎるセットアップ手順書: 新しいメンバーがチームに参加するたびに、OSごとの膨大なセットアップ手順書をメンテナンスし、実行してもらう必要がある。手順のどこかでミスが起きれば、トラブルシュートに多大な時間がかかります。

これらの問題は、開発者の貴重な集中力と時間を奪い、本来の目的である「良いプロダクトを作ること」から私たちを遠ざけてしまいます。もし、これらの悩みを魔法のように解決できるツールがあるとしたら、知りたくありませんか？その答えが、今回ご紹介する Docker なのです。

Dockerの基礎知識：コンテナって何？なぜ「ポータブル」なの？

Dockerを理解する鍵は、コンテナ という技術にあります。よく仮想マシン (VM) と比較されますが、両者には明確な違いがあります。

仮想マシンは、Hyper-VやVirtualBoxのように、ハードウェアの上にホストOSを置き、その上にさらにゲストOSを丸ごとインストールする技術です。まるで「パソコンの中にもう一台、仮想的なパソコンを作る」ようなイメージです。OSがまるごと動くため分離性は高いですが、起動が遅く、多くのメモリやディスク容量を消費するのが難点です。

一方、コンテナはホストOSのカーネル（OSの中核部分）を共有します。OSを丸ごと動かすのではなく、アプリケーションと、その実行に必要なライブラリや設定ファイルだけを隔離された空間（コンテナ）にパッケージングします。これは「アプリケーション専用の、軽量な個室を用意する」ようなイメージです。OSのオーバーヘッドがないため、非常に軽量で、数秒で起動・停止できます。

そして、この「個室」こそがDockerのポータブル性の秘密です。アプリケーションの実行に必要なものがすべてパッケージングされているため、Dockerが動作する環境であれば、macOSでもWindowsでもLinuxでも、全く同じように動作します。この仕組みは、世界中の物流を支える海上コンテナに似ています。中身が精密機械であろうと果物であろうと、コンテナの規格さえ合っていれば同じ船で運べるように、Dockerコンテナも中身のアプリケーションを問わず、どんな環境へも「運んで動かす」ことができるのです。

手を動かして実感！DockerでシンプルWebアプリを動かしてみよう

理屈はこれくらいにして、実際に手を動かしてDockerのパワーを体感してみましょう。ここでは、シンプルなWebアプリケーションをDockerコンテナ内で動かしてみます。ご自身のPCにPythonや関連ライブラリをインストールする必要は一切ありません。必要なのはDocker Desktopだけです。

まず、プロジェクト用のディレクトリを作成し、以下の3つのファイルを用意してください。

1. Webアプリケーション本体 (app.py) “Hello from Docker!” というメッセージを返す、ごく簡単なWebアプリです。

from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello():
    return "<h1>Hello from Docker!</h1>"

if __name__ == '__main__':
    # 外部からアクセスできるよう host='0.0.0.0' を指定
    app.run(host='0.0.0.0', port=5000)

2. 依存ライブラリの定義 (requirements.txt) このアプリが必要とするライブラリ（今回はFlask）を記述します。

Flask==3.0.0

3. Dockerコンテナの設計図 (Dockerfile) これがDockerの心臓部です。コンテナをどう作るかを指示します。

# ベースとなる公式のPythonイメージを指定
FROM python:3.11-slim

# コンテナ内の作業ディレクトリを設定
WORKDIR /app

# 依存ライブラリの定義ファイルを先にコピー
COPY requirements.txt .

# 依存ライブラリをインストール
RUN pip install --no-cache-dir -r requirements.txt

# プロジェクトのファイルをすべてコピー
COPY . .

# コンテナ起動時に実行するコマンドを指定
CMD ["python", "app.py"]

ファイルが準備できたら、ターミナルで以下のコマンドを実行します。

# 1. Dockerfileを元に "my-first-app" という名前のイメージをビルド
docker build -t my-first-app .

# 2. ビルドしたイメージからコンテナを起動
# -p 8080:5000 は、PCの8080番ポートへのアクセスをコンテナの5000番ポートへ転送する設定
docker run -p 8080:5000 my-first-app

コマンドが成功したら、Webブラウザで http://localhost:8080 にアクセスしてみてください。「Hello from Docker!」と表示されたはずです。あなたのPCに直接Pythonをインストールしていなくても、アプリケーションが完璧に動作しました。これがDockerの力です！

複数のサービスを連携！Docker Composeで「まるごと」開発環境を構築

実際のアプリケーション開発では、Webサーバー単体で完結することは稀で、データベースやキャッシュサーバーなど、複数のサービスが連携して動作します。これらを一つずつ docker run コマンドで起動・管理するのは大変です。

そこで登場するのが Docker Compose です。YAML形式のシンプルな設定ファイル (docker-compose.yml) を一つ書くだけで、複数のコンテナからなるアプリケーション全体を「まるごと」定義し、コマンド一発で起動・停止できるようになります。

先ほどのWebアプリに、データキャッシュ用のRedisサーバーを追加してみましょう。プロジェクトのルートに docker-compose.yml というファイルを作成します。

docker-compose.yml

services:
  # Webアプリケーションサービス
  web:
    build: .
    ports:
      - "8080:5000"
    volumes:
      # ホストPCの現在のディレクトリをコンテナの/appに同期
      - .:/app
    depends_on:
      - redis

  # Redisサービス
  redis:
    image: "redis:7.2-alpine"

この設定ファイルには、web と redis という2つのサービスが定義されています。

  • web サービス: 先ほど作成した Dockerfile を元にビルドします。
  • redis サービス: 公式で提供されているRedisのDockerイメージ (redis:7.2-alpine) をそのまま使います。
  • volumes: web サービスで最も重要な設定の一つです。これにより、ホストPC上のソースコードがコンテナ内の /app ディレクトリに直接マウント（同期）されます。コードを修正するたびにイメージを再ビルドする必要がなくなり、変更が即座にコンテナに反映されるため、開発効率が劇的に向上します。

準備ができたら、ターミナルで以下のコマンドを実行するだけです。

# アプリケーション全体を起動（バックグラウンドで実行する場合は -d オプションを付ける）
docker compose up

# アプリケーション全体を停止し、コンテナやネットワークを削除
docker compose down

たったこれだけで、WebサーバーとRedisサーバーが起動し、互いに通信できる状態でセットアップが完了します。この docker-compose.yml ファイルをチームで共有すれば、誰でも docker compose up の一言で、完全に同じ構成の開発環境を手に入れることができるのです。

Dockerをもっと活用！開発効率を上げる実践テクニック

DockerとDocker Composeの基本をマスターすれば、開発ワークフローはすでに大きく改善されているはずです。ここでは、さらに一歩進んで、より快適で効率的な開発を実現するための実践的なテクニックをいくつかご紹介します。

.dockerignore でビルドを高速化

Dockerfile と同じ階層に .dockerignore ファイルを置くと、.gitignore と同じ要領で、イメージに含めたくないファイルやディレクトリを指定できます。COPY . . のような命令を実行する際に、これらのファイルがコンテナにコピーされなくなるため、ビルド時間の短縮や、最終的なイメージサイズの削減に繋がります。特に、node_modules や venv、.git といった巨大なディレクトリは必ず指定しましょう。

マルチステージビルドでイメージを軽量化

本番環境で動かすイメージは、可能な限り小さく、セキュアであることが望ましいです。マルチステージビルドは、Dockerfile の中でビルド用のステージと実行用のステージを分けるテクニックです。例えば、ビルド時にだけ必要なコンパイラや開発用ライブラリを最初のステージで使い、最終的に生成された実行ファイルや成果物だけを、クリーンな実行用イメージにコピーします。これにより、不要なファイルを含まない、スリムでセキュアな本番用イメージを作成できます。

VS Code拡張機能 (Remote - Containers) の活用

Visual Studio Codeをお使いなら、「Remote - Containers」拡張機能は必見です。この拡張機能を使うと、VS Codeのエディタ自体をDockerコンテナの中で直接実行できます。これにより、ローカルPCに必要なのはDockerとVS Codeだけで、プロジェクトごとの言語（Python, Node.js, Goなど）やリンター、フォーマッターといったツール類はすべてコンテナ内に閉じ込めることができます。PC本体をクリーンに保ちつつ、プロジェクトごとに完全に最適化された開発環境をシームレスに利用できる、まさに究極の環境分離と言えるでしょう。

まとめ：Dockerで手に入れる、ストレスフリーな開発の未来

この記事では、開発現場の様々な「モヤモヤ」を解決するツールとして、Dockerとそのエコシステムを紹介しました。

  • Dockerコンテナは、アプリケーションと実行環境をセットでパッケージ化し、どこでも同じように動く 「ポータビリティ」 を実現します。
  • Dockerfile というコードで環境を定義することで、「誰でも」「いつでも」 同じ開発環境を正確に再現できます。
  • Docker Compose を使えば、データベースなどを含む複数のサービスからなる複雑なアプリケーションも、コマンド一つで 「まるごと」 管理できます。
  • volumes 機能によるコードのライブ同期や、各種最適化テクニックを駆使することで、開発効率化 がさらに加速します。

Dockerの学習は、単に新しいツールを覚えること以上の価値をもたらします。それは、「環境構築」という不確実で時間のかかる作業から開発者を解放し、私たちが本来集中すべき「アイデアを形にし、価値あるソフトウェアを創造する」という本質的な活動に時間を使えるようにするための、強力な投資です。

さあ、あなたの次のプロジェクトから、Dockerを取り入れてみませんか？きっと、これまで悩まされてきた多くの問題から解放され、コーディングがもっと楽しくなるはずです。

#docker #containerization #development-workflow #devops-basics

関連記事

Dockerで「自分のPCだけ動く」を撲滅！チーム開発のボトルネックを解消する

Dockerで「私のPCでは動く」を解決！開発から本番デプロイまで統一する鍵

TDD（テスト駆動開発）入門：Pythonで学ぶRed/Green/Refactor実践