メインコンテンツへスキップ
見出し画像

コマンドの入力ミスで心を折らないために。Docker Composeで手に入れる「片付けまで気持ちいい」開発環境

    Dockerの勉強を始めたばかりの人は、コンテナを動かすたびにあの長い docker run コマンドを何度も打つの、正直面倒くさくなってないですか?

    ポート番号は何番だったか、ボリュームのパスはどう書くんだったか、環境変数はどの順番か——一つでも間違えるとエラーが出て、また調べ直す。それを2つ、3つのコンテナ分やるとなると、もう心が折れそうになります。

    学習のモチベーションを消耗するのが、コマンドの入力ミスだというのは、どこかおかしい気がしていました。

    今回の記事で、その問題が解決します。

    キーワードは Docker Compose(ドッカーコンポーズ)。これを使いこなせると、「コマンド1行を打つだけで、複数のコンテナが一斉に起動している」という世界に入れます。

    コマンドはすべてそのままコピペで動きます。ぜひ手を動かしながら読んでみてください。

    この記事を読み終えると、こんな状態になっています。

    ・あの長い docker run コマンドを毎回打つ苦痛から解放されている
    ・docker-compose.yml の書き方の基本がわかっている
    ・コマンド1行で、WordPressとDBが連携した環境を起動・停止できている
    ・複数コンテナの管理が「ファイルに書いて up するだけ」に変わっている

    まず押さえよう:Docker Composeって何?

    これまで、コンテナを動かすたびにこういうコマンドを打っていました。

    docker run -d -p 8080:80 -v 自分のフォルダ:コンテナのフォルダ ... [イメージ名]

    Webサーバー・データベース・キャッシュサーバーの3つが必要な構成だとしたら、この長いコマンドを3回間違えずに打たなければなりません。現実的ではないですよね。

    Docker Composeは、この問題をファイルで解決します。

    「どのコンテナを」「どんな設定で」「どう繋げて起動するか」をすべて1つのファイルに書いておいて、あとは docker compose up の1行を打つだけ——それがDocker Composeの仕組みです。

    よく「オーケストラの指揮者」に例えられます。指揮者が「演奏始めて」と指示を出すだけで、各演奏者(コンテナ)が正しいタイミングで動き出す。コンテナが何個に増えても、あなたが打つコマンドは常に1行だけです。

    Step 1|作業フォルダを作る

    PowerShell(またはMacのターミナル)を開いて実行してください。

    cd ~/Desktop
    mkdir docker-compose-test
    cd docker-compose-test

    Step 2|設定ファイル docker-compose.yml を作る

    Docker Composeでは、Dockerfileの代わりに docker-compose.yml という設定ファイルを使います。すべてのコンテナの設定をここに書き溜めます。

    ファイルの作成(Windows PowerShell):

    New-Item -Path . -Name "docker-compose.yml" -ItemType "file"
    notepad docker-compose.yml

    メモ帳が開いたら、以下の内容を丸ごとコピペして保存してください。

    services:
      # ① データベース用コンテナ(名前はdb)
      db:
        image: mariadb:10.6
        environment:
          MARIADB_ROOT_PASSWORD: secretpassword
          MARIADB_DATABASE: wordpress
    
      # ② WordPress用コンテナ(名前はwordpress)
      wordpress:
        image: wordpress:latest
        ports:
          - "8080:80"
        environment:
          WORDPRESS_DB_HOST: db
          WORDPRESS_DB_USER: root
          WORDPRESS_DB_PASSWORD: secretpassword
          WORDPRESS_DB_NAME: wordpress

    ⚠️ YAMLファイルを扱うときの絶対ルール

    YAMLは「半角スペースのインデント(字下げ)」で階層関係を表します。スペースがズレていたり、Tabキーが混入していたりすると必ずエラーになります。 コピペ後に字下げがズレていないか必ず確認してください。

    ファイルに出てくる主なキーワードの意味:

    • services:これから起動するコンテナのグループを定義する宣言

    • image:コンテナの土台にするDockerイメージを指定する

    • environment:コンテナ内に設定する環境変数(パスワードや設定値)を指定する

    • ports:自分のPCとコンテナのポートを繋ぐ設定

    ファイルの中身をもう少し細かく見ておきます。

    db コンテナはデータベース(MariaDB)の設定です。MARIADB_DATABASE: wordpress と書くことで、WordPress用のデータベースをコンテナ起動と同時に自動作成するよう指示しています。

    wordpress コンテナの WORDPRESS_DB_HOST: db が特に重要です。
    「データベースはどこにある?」という問いに対して、IPアドレスを調べる必要はありません。先ほど定義したコンテナ名 db と書くだけで、Dockerが裏側で自動的に通信を繋いでくれます。これがDocker Composeの地味に凄いところです。

    Step 3|コマンド1行で一斉起動する

    ファイルを保存したら、以下を実行するだけです。

    docker compose up -d

    「docker-compose」ではなく「docker compose」です。

    古い記事や教材ではハイフン付きの docker-compose と書かれていることがありますが、現在の標準はハイフンなしの docker compose です。今後はこちらで覚えておきましょう。

    コマンドを実行すると、mariadb と wordpress のイメージが自動でダウンロードされ、2つのコンテナが同時に起動します。

    Step 4|ブラウザで確認する

    ブラウザを開いて、アドレスバーに入力してください。

    http://localhost:8080

    WordPressの言語選択画面が表示されれば大成功です。

    裏側では、WordPressコンテナが自動的に db コンテナを見つけ出して、データベースとの通信を確立しています。本来なら手動でネットワーク設定が必要な工程を、Docker Composeが全部やってくれています。

    コマンドを1行打っただけで、WordPressが動いている。この事実がちょっと信じられませんでした。そういう感動が、学習のモチベーションになります。

    Step 5|コマンド1行で全部片付ける

    使い終わったら以下を実行してください。

    docker compose down

    動いていた2つのコンテナが同時に停止して、そのまま削除まで完了します。

    これまでは docker stop [コンテナ名] → docker rm [コンテナ名] をコンテナの数だけ繰り返していました。それが、たった1行。この片付けの気持ちよさも、Docker Composeの大きな魅力の一つです。

    まとめ:今回覚えたコマンドは3つだけ

    • docker compose up -d:docker-compose.yml をもとに全コンテナをまとめて起動する

    • docker compose down:起動中の全コンテナをまとめて停止・削除する

    • docker compose ps:Composeで起動しているコンテナの状態を一覧表示する

    長いコマンドをメモ帳に貼り付けて使い回す日々は、もう終わりです。設定はファイルに書いて up するだけ。down の1行で全部消える。 この気持ちよさ、一度体験するとなかなか忘れられません。

    今回の内容をさらに深めたい方へ。

    本編で作ったWordPress環境に、データベースの中身をブラウザで確認できるツール「Adminer」を3つ目のコンテナとして追加する演習問題を別記事で公開しています。
    「コンテナを1つ増やす」という操作を自分の手でやることで、Docker Composeの強みが本当の意味で体にしみます。

    ぜひ挑戦してみてください👇

    「コンテナ増えすぎてコマンド覚えられない…」を1発解決!Docker Composeを完全攻略

    「やってみた!」「ここで詰まった」という方は、コメントで教えてもらえると嬉しいです。スキやフォローも励みになります。

     
     
    ネットワーク弱者だった社会人が、ネットワークエンジニアになるためにスキルを身につけた方法を大公開。 応用情報・ネスぺ・セキスぺ3冠達成。日々の学習のノウハウも展開していきます。 ブログ(1up-method.com)もやっているのでよければそちらも覗いてみて下さい!

    あなたへのおすすめ