ikuma-t.

動機

昨今の開発において、常識になっているDocker。

私もそろそろ学ばねばということで、書籍を使って概要を掴みました。

仕組みと使い方がわかる Docker＆Kubernetesのきほんのきほん (Compass Booksシリーズ)

• 作者:小笠原 種高
• $1

Amazon

Dockerの仕組み、Dockerfile、Docker Composeの基本はわかったけれど、実際にRailsアプリを動かしてみたらどうなるんだろう？と気になっていたところ、RubyMineの公式がDocker Compose環境でRailsを動かすサンプルRailsを公開していたので、Railsアプリの起動までやってみました。

やること

チュートリアル: リモートインタープリターとしての Docker Compose | RubyMineをやる

サンプル$1：

github.com

やってみる

まずはgit clone

コマンドでも構いませんが、RubyMineを使用しているので、「Get from VCS」からサンプルVCSのURLを設定して、cloneを実施します。

DB設定をPostgresqlに変更する

cloneした時点ではDB設定がsqlite3になっているようなので、config/database.ymlを開き、使用するDBを変更します。

コンテナを起動する

次にdocker-compose.ymlを開いて、ガターにある矢印アイコンを押します。

これで/usr/local/bin/docker-compose -f /Users/tadokoroikuma/RubymineProjects/sandbox/sample_rails_app/docker-compose.yml up -dというコマンドが実行されます。

つまりは、このdocker-compose.ymlをベースとして、バックグラウンドでサービス（コンテナ）を起動するわけです。
これでPostgresqlとRubyのコンテナがそれぞれ作成&起動されます。

Rubyーとして、コンテナ上のRubyを指定する

次にRubyMineに対して、コンテナ上のRubyを参照するように設定します。

Preferences > Ruby SDK and Gemsを開き、「+」から「New Remote」を選択します。

続いて、Docker ComposeのwebコンテナのRubyを参照するように設定し、「OK」を押します。

DB作成と$1を行う

次にrails db:createとrails db:migrateを実施します。
これに限らずですが、ターミナルからコンテナに入ってコマンドを直接実行する方法と、RubyMineの機能を使って実行する方法の2種類があるので、それぞれ解説します。

ターミナルからコンテナに入ってコマンドを直接実行する方法

# webコンテナを指定してコマンドを実行する（bashを起動する）$ docker-compose exec web bash # DBの作成を行う（rails db:migrateも同様）$ rails db:createCreated database 'sample_rails_app_db'Created database 'sample_rails_app_db_test

RubyMineの機能を使って実行する方法

RubyMineのRunAnythingに包含されている、Rake Taskの実行を用いて起動します。
（rakeタスクのコマンドはrailsコマンドに移管されたのですが、RubyMineの機能を使う場合は、Rakeタスクとして扱う必要があります。というかRailsコマンドで実行しても結局はRakeタスクを叩いているだけなので…）

^を2回押して、RunAnythingを呼び出し、rake --tasksと入力してEnterで実行します。

これをしないとどうもDocker環境でRakeタスクが認識できないようで…（これは不便）。

これでRakeタスクが使えるようになったので、RunAnythingからrake db:createを実行します（rake db:migrateも同様）

DBが作成されたか確認する

$1にはありませんが、RubyMineのDBクライアント機能を使って作成されたDBを確認してみましょう。

まずはDatabaseツールウィンドウを開いて、「+」ボタンからDataSourceとしてPostgreSQLを選択します。

次に接続に必要な情報を以下の通り設定していきます。

入力が完了したら、TestConnectionを行い、問題なければOKを押してください。

うまくいけばこのようにDatabaseの中身を確認することができます。

Railsアプリケーションの実行

RAILSの実行対象に「DEVELOPMENT:SAMPLE_RAILS_APP」を指定し、再生ボタンを押します。

ブラウザを開き、http://0.0.0.0:3000/にアクセスするとサンプルアプリが起動します。

なおターミナルから実行する場合は以下のようにします。

$ docker-compose exec web bash$ bin/rails s -b 0.0.0.0

バインドマウントがされているか確認してみる

後述のdocker-composeの設定で、node_modulesを除くすべてのファイルの変更がコンテナ上に反映されます。
実際にソースを少し改変して、反映されることを確認してみましょう。

app/views/static_pages/home.html.erbを開き、23行目にある内容を書き換えてみましょう。

    <h2>      BindMountTest      This is the home page for the      <a href="https://www.railstutorial.org/">Ruby on Rails Tutorial</a>      sample application.    </h2>

この状態でアプリをリロードします。

たしかに内容が変更されていることが確認できました。

定義ファイルを確認する

ここまでで実際にRailsアプリを立ち上げることができました。ここからはこの環境を作成した定義ファイルを確認していきたいと思います。

docker-compose.yml

まずはdocker-compose.ymlからです。

version: '3'services:  db:    image: postgres    volumes:      - ./tmp/db:/var/lib/postgresql/data    environment:      POSTGRES_HOST_AUTH_METHOD: trust    ports:      - "54333:5432"  web:    build: .    command: tail -f /dev/null    volumes:      - .:/sample_rails_application      - /sample_rails_application/node_modules    ports:      - "3000:3000"      # Ports required for debugging      - "1234:1234"      - "26166:26168"    depends_on:      - db

順番に見ていきます。

version: '3'

これは使用するDocker Composeのバージョンを指定しているだけです。
今回はバージョン3を指定しています。

services:  db:    # 略  web:    # 略

次にservices、つまり使用するコンテナの設定です。今回はdbというコンテナとwebというコンテナの2種類を立てます。
順を追ってみてみましょう。まずはdbコンテナです。

  db:    image: postgres    volumes:      - ./tmp/db:/var/lib/postgresql/data    environment:      POSTGRES_HOST_AUTH_METHOD: trust    ports:      - "54333:5432"

以下各定義内容の説明です。

volumesの指定は、Dockerの2つある方法のうちの「バインドマウント（Dockerエンジン上ではなく、ホストの指定した箇所に保存する）」の指定で、:を境にホスト:コンテナのように指定されています。

参考：Postgres - Official Image | Docker Hub

続いてwebコンテナを確認します。

  web:    build: .    command: tail -f /dev/null    volumes:      - .:/sample_rails_application      - /sample_rails_application/node_modules    ports:      - "3000:3000"      # Ports required for debugging      - "1234:1234"      - "26166:26168"    depends_on:      - db

こちらも同様に各定義内容の説明です。

結構ややこしいのが、node_modulesの名前なしボリュームでのマウントです。
まず先の通り、手元のソースの反映はバインドマウントによって、すべてコンテナ上と同期されます。
こうすると、ホスト上とコンテナ上のnode_modulesがそれぞれ同期されてしまうのですが、せっかくコンテナ上で固定したnodeが、ホストによって破壊されることになってしまいます。

そのため、node_modulesのみはバインドの対象外とするのですが、コンテナが破棄されたのちもデータを永続化するため、DockerEngine上に名前なしボリュームとしてマウントする手段をとっています。

参考：VSCode&Docker Volumeにおけるnode_modules問題を解決する

ここまでに記述した内容でたしかにコンテナが起動しているかは、コマンドでも確認することができますが、RubyMineのServicesタブを使って確認することができます。

webコンテナのポート$1ード設定を確認

Dockerfile

つづいて、Dockerfileです。

# ruby2.7.2のイメージを使用するFROM ruby:2.7.2# yarnのリポジトリを追加します（apt-key add -は標準入力の内容を追加します。つまりcurlで取得した内容を追加します）RUN curl -sL https://dl.yarnpkg.com/debian/pubkey.gpg | apt-key add -# teeコマンドを使ってyarnのAPTパッケージレポジトリを自分のシステムに追加しますRUN echo "deb https://dl.yarnpkg.com/debian/ stable main" | tee /etc/apt/sources.list.d/yarn.list# 必要なパッケージをインストールしますRUN apt-get update -qq && apt-get install -y build-essential libpq-dev nodejs postgresql-client yarn# RUN CMD ENTRYPOINT ADD COPYの際の作業ディレクトリを`/sample_rails_application`に指定RUN mkdir /sample_rails_applicationWORKDIR /sample_rails_application# 必要な初期設定系ファイルのコピーCOPY Gemfile /sample_rails_application/GemfileCOPY Gemfile.lock /sample_rails_application/Gemfile.lockCOPY package.json /sample_rails_application/package.jsonCOPY yarn.lock /sample_rails_application/yarn.lock# 初期設定系のインストールRUN gem install bundler -v '2.2.15'RUN bundle installRUN yarn install --check-files# イメージに`. /sample_rails_application`の内容を追加するCOPY . /sample_rails_application# ポート3000で通信するEXPOSE 3000

このimageを元に、docker-composeのwebコンテナは作成されるようです。

感想

素晴らしい書籍のおかげでDockerの基礎を理解できたのはよいものの、実際にRailsアプリを一から起動するとなると、ややハードルが高かったです。
しかしながら、この$1はすでに出来上がっている$1を使ってアプリを動かすので、その中継点として非常にちょうどいい題材だと思いました。

一点気になったのが、node_modulesはVolumeTrickを使って名前なしボリュームにマウントしているのに、Gemfileはいいのか？というところです。
なんか同じような類なので、Gemfileもボリュームマウントした方がいい気がするんですが、その話はまた別の機会に調べようと思います。