Docker超入門：開発環境コンテナ：Ruby on Rails②

このページで解説している内容は、以下の YouTube 動画の解説で見ることができます。

Docker超入門：開発環境コンテナ：Ruby on Rails②

🐳 開発環境コンテナ：Ruby on Rails②

前回の「Ruby on Railsコンテナ①」でDockerfileを定義し、Rails環境を準備しましたね。
　今回はその続きとして、compose.yamlファイルの作成とRailsプロジェクトの生成を行っていきます。
構築する「開発環境コンテナ：Ruby on Rails」は下図のとおりです。

ここでは、Railsアプリケーションが実際にMariaDBと連携できる状態まで整っていきます。

「開発環境コンテナ：Ruby on Rails」は3部構成で進めています。

• 開発環境コンテナ：Ruby on Rails①
• 開発環境コンテナ：Ruby on Rails②← 今回はこちら
• 開発環境コンテナ：Ruby on Rails③

⚙️ compose.yamlファイルの作成

まずはDocker Composeを使って、複数のコンテナをまとめて管理できるようにします。

VSCodeでファイルを作成します👇

code compose.yaml

VSCodeが開いたら、以下の内容を入力して保存しましょう。

services:
  db:
    image: mariadb:10.7
    container_name: mariadb_container
    environment:
      MARIADB_ROOT_PASSWORD: testpass
      MARIADB_DATABASE: samplerails_development
    volumes:
      - db-data:/var/lib/mysql
    healthcheck:
      test: ["CMD-SHELL", "mysqladmin ping -h localhost -u root -ptestpass --silent"]
      interval: 5s
      timeout: 3s
      retries: 20
      start_period: 60s

  web:
    build: .
    container_name: rails_container
    depends_on:
      db:
        condition: service_healthy
    environment:
      RAILS_ENV: development
      DATABASE_HOST: db
      DATABASE_PORT: 3306
      DATABASE_USER: root
      DATABASE_PASSWORD: testpass
    ports:
      - "3000:3000"
    volumes:
      - .:/samplerails
    command: >
      bash -c "
        echo 'Waiting for MariaDB to be ready...' &&
        until mysqladmin ping -h db -u root -ptestpass --silent; do
          sleep 2;
        done &&
        echo 'MariaDB is ready. Running db:prepare...' &&
        bundle exec rails db:prepare &&
        bundle exec rails s -b 0.0.0.0"
volumes:
  db-data:

🧱 定義内容の解説

　このcompose.yamlでは、MariaDBコンテナ（db）とRailsコンテナ（web）の2つのサービスを定義しています。

💡 ポイント

• depends_onでdbの起動完了（ヘルスチェック成功）を待ってからRailsを起動するよう制御しています。
• volumesを使って、ホストのソースコードをコンテナ内に反映します。
• commandでMariaDBの起動確認を自動化しており、DBが準備できるまで待機してからRailsを起動します。

🩺 healthcheckの動作解説

MariaDBの準備完了を確認するために、healthcheckセクションを使っています。

healthcheck:
  test: ["CMD-SHELL", "mysqladmin ping -h localhost -u root -ptestpass --silent"]
  interval: 5s
  timeout: 3s
  retries: 20
  start_period: 60s

💡 ポイント

　healthcheckを設定しておくことで、MariaDBの起動が完全に終わる前にRailsが接続を試みてエラーになる問題を防げます。

test: ["CMD-SHELL", "mysqladmin ping -h localhost -u root -ptestpass --silent"] の解説

この行は Docker Composeの healthcheck 機能 の一部で、
　MariaDB コンテナ（DBコンテナ）が「起動して正常に動作しているか？」を自動で確認するための テストコマンド を指定しています。

では、1つずつ丁寧に分解して解説します👇

🩺 コマンド全体の役割

test: ["CMD-SHELL", "mysqladmin ping -h localhost -u root -ptestpass --silent"]

これは、Docker Composeの healthcheck セクション内で使われる定義です。
目的はシンプルで、

MariaDBコンテナが「応答できる状態」かどうかを定期的に確認する

というものです。
もし正常に動いていれば「Healthy（正常）」、
応答できなければ「Unhealthy（異常）」という状態をDockerが判断します。

🧩 各要素の意味

🧠 実際の動作の流れ

1. Docker は MariaDB コンテナを起動したあと、healthcheck の test コマンドを定期的に実行します。
2. 内部的には次のように動きます👇
   /bin/sh -c "mysqladmin ping -h localhost -u root -ptestpass --silent"
3. mysqladmin ping コマンドが「サーバーが起動して応答可能」なら成功（exit code 0）になります。
4. 成功（0）であればコンテナは「healthy」とマークされ、
   失敗（非0）なら「unhealthy」とマークされます。

🧱 mysqladmin ping の動作

ここで使われている mysqladmin ping は、
MySQL / MariaDB が起動し、クライアントの接続を受け付けられる状態かを確認するサブコマンドです。

mysqladmin ping -h localhost -u root -ptestpass --silent

「-p testpass」ではなく「-ptestpass」なのか

実はこれ、MySQL系コマンド（mysql・mysqladminなど）の特殊な仕様なんです。
見た目がちょっと不自然に見えるけど、正しい書き方なんですよ。

では詳しく説明していきましょう👇

💡 結論から言うと

-pTESTPASS   ✅ 正しい書き方
-p TESTPASS  ❌ 間違い（もしくは無視される）

MySQLのコマンドでは、
-pオプションのあとに「スペースを入れずに」パスワードを書く
というルールになっています。

🧩 理由：MySQLクライアントのオプション解析の仕組み

MySQL（およびMariaDB）のコマンドは、-pを見たときにこう動作します👇

つまり、スペースを入れると「次の引数は別の意味」だと認識されてしまうんです。

🧠 command の動作解説

　Railsコンテナの中でどんな順序で処理を実行するかを指定しているのが、このcommandセクションです。
RailsとMariaDBを確実に連携させるための仕掛けになっています👇

command: >
  bash -c "
    echo 'Waiting for MariaDB to be ready...' &&
    until mysqladmin ping -h db -u root -ptestpass --silent; do
      sleep 2;
    done &&
    echo 'MariaDB is ready. Running db:prepare...' &&
    bundle exec rails db:prepare &&
    bundle exec rails s -b 0.0.0.0"

このスクリプトの流れを説明します👇

💡 この設定のねらい

通常、MariaDBの起動には少し時間がかかるため、Railsがすぐに起動すると「DB接続できません」エラーが出がちです。
このcommand:定義により、Railsが自動的にMariaDBの準備完了を待ってから起動するため、安定した立ち上げが可能になります。

mysqladmin ping -h db -u root -ptestpass の解説

このコマンドは MariaDB（またはMySQL）サーバーに接続できるかを確認するためのコマンド です。
つまり、「DBがちゃんと起動して、接続を受け付けられる状態になっているか？」をチェックします。

では、1つずつ分解して説明します👇

🧩 コマンド全体

mysqladmin ping -h db -u root -ptestpass

このコマンドは、mysqladmin というMySQL/MariaDB管理ツールを使って、
ホスト（ここでは db）上のデータベースサーバーが応答できるかを「ping」するものです。

🧱 各部分の意味

💬 実行時の動作

このコマンドを実行すると、MariaDBサーバーに対して以下のようなやりとりが行われます👇

1. db ホスト（＝MariaDBコンテナ）に TCP 接続を試みる。
2. ユーザー root とパスワード testpass を使ってログインを試みる。
3. サーバーが応答可能であれば、次のようなメッセージを返します。
   mysqld is alive

4. もしサーバーがまだ起動途中なら、エラーが返ります。
   mysqladmin: connect to server at 'db' failed

healthcheck と command の両方必要？

　この「healthcheck」と「command内のMariaDB待機処理」は、どちらも“DBが起動するまで待つ”という目的は同じですが、
役割と実行タイミングが違うため、併用するとより安全に動作します。
ただし、構成によってはどちらか一方だけでも動作します。
順に詳しく説明します👇

🩺 ① healthcheck の役割

healthcheckは、MariaDBコンテナの“内部状態”を監視する仕組みです。
Composeに次のように書かれていますね。

healthcheck:
  test: ["CMD-SHELL", "mysqladmin ping -h localhost -u root -ptestpass --silent"]
  interval: 5s
  timeout: 3s
  retries: 20
  start_period: 60s

この定義により、MariaDBコンテナ内で5秒ごとにmysqladmin pingを実行し、
「DBが応答できる状態になったか？」をチェックします。

健康状態（Healthy／Unhealthy）はComposeの内部で管理され、
depends_on: condition: service_healthy で他のコンテナに伝わります。

💡 つまり…

• healthcheck は MariaDBの中で動く監視（Dockerエンジンが評価）
• Railsコンテナは 「dbがhealthyになったら起動してOK」 という判定をもらってからスタート

✅ ポイント
これで「MariaDBがまだ初期化中なのにRailsが先に起動して接続失敗」という事態をかなり防止できます。

🧠 ② command内の待機処理の役割

次に、Rails側のcommand:の中でやっているこの部分です👇

command: >
  bash -c "
    echo 'Waiting for MariaDB to be ready...' &&
    until mysqladmin ping -h db -u root -ptestpass --silent; do
      sleep 2;
    done &&
    echo 'MariaDB is ready. Running db:prepare...' &&
    bundle exec rails db:prepare &&
    bundle exec rails s -b 0.0.0.0"

このスクリプトは、Railsコンテナの中で実際にMariaDBへ接続を試みて待機する処理です。
つまり、healthcheckよりもさらに実戦的な接続確認です。

Rails側では次の順に動きます👇

✅ ポイント
healthcheckが「MariaDBが動作可能か」を判断するのに対して、
command内では「Railsが実際にMariaDBへ接続できるか」をチェックしています。

⚖️ 両方とも必要なの？

結論をまとめると以下の通りです👇

💡 実運用では“両方併用”がベスト

🛠️ Railsプロジェクトの作成

続いて、Railsアプリケーション本体を作成します。

コマンドはこちら👇

docker compose run --rm web rails new . --force --no-deps --database=mysql

　このコマンドは、Docker Composeを使って一時的なRailsコンテナを起動し、プロジェクトを自動生成します。

💡 ポイント

このコマンドを使うと、Railsの基本構成ファイル（Gemfileやconfigフォルダなど）が自動で作成されます。

🖥️ 実行結果

実行には少々時間がかかります。

PS C:\Users\joeac\Desktop\docker\rails> docker compose run --rm web rails new . --force --no-deps --database=mysql
time="2025-10-20T01:43:53+09:00" level=warning msg="The \"DATABASE_PASSWORD\" variable is not set. Defaulting to a blank string."
[+] Running 9/9
 ✔ db Pulled                                                                                               10.2s
   ✔ d3da17671559 Pull complete                                                                             0.7s
（省略）
Bundle complete! 14 Gemfile dependencies, 87 gems now installed.
（省略）

　完了メッセージに「Bundle complete! 14 Gemfile dependencies, 87 gems now installed.」と表示されれば成功です。
これでRailsプロジェクトの雛形が生成されました。

⛔ 一時コンテナの停止

Railsプロジェクトを作成したコンテナは一時的なものなので、作業後に停止します。

docker compose stop

実行結果👇

PS C:\Users\joeac\Desktop\docker\rails> docker compose stop
[+] Stopping 1/1
 ✔ Container mariadb_container  Stopped                                                                     1.6s
PS C:\Users\joeac\Desktop\docker\rails>

🗂️ Railsプロジェクトの確認

VSCodeのエクスプローラでrailsフォルダを開くと、次のような構成になっています。

これでRailsプロジェクトの基盤が整いました！

　この続きでは「開発環境コンテナ：Ruby on Rails③」で、database.ymlの設定変更とコンテナの起動・動作確認を行っていきます。

✅ まとめ

次はいよいよ Railsコンテナの起動とブラウザ表示の確認 に進みます。
ここまで来れば、あなたの開発環境はほぼ完成です！ 🎉