アンコードブログ

Docker for MacでRails + PostgreSQLの開発環境を構築

2019年6月21日

Web

こんにちは。hirohiroです。

Dockerをインストールし、Rails + PostgreSQLの開発環境を構築しましたので、記事にまとめてみました。

Docker for Mac をダウンロード

公式サイトより、Docker for Macをダウンロードします。

https://docs.docker.com/docker-for-mac/install/

Dockerの起動

Dockerを起動すると、以下の画面が出てくるのでNextを選択。

続いて、OK として次画面にて端末のパスワードを入力する。

上から画面が出てくるので、DockerのIDとパスワードを入力します。

上部のメニューバーのDockerアイコンを押すと下のようなメニューが表示されます。

インストールの確認

正しくインストールされているか確認

$ docker version
Client: Docker Engine - Community
 Version:           18.09.2
 API version:       1.39
 Go version:        go1.10.8
 Git commit:        6247962
 Built:             Sun Feb 10 04:12:39 2019
 OS/Arch:           darwin/amd64
 Experimental:      false

Server: Docker Engine - Community
 Engine:
  Version:          18.09.2
  API version:      1.39 (minimum version 1.12)
  Go version:       go1.10.6
  Git commit:       6247962
  Built:            Sun Feb 10 04:13:06 2019
  OS/Arch:          linux/amd64
  Experimental:     false

$ docker version

Client: Docker Engine - Community

Version: 18.09.2

API version: 1.39

Go version: go1.10.8

Git commit: 6247962

Built: Sun Feb 10 04:12:39 2019

OS/Arch: darwin/amd64

Experimental: false

Server: Docker Engine - Community

Engine:

Version: 18.09.2

API version: 1.39 (minimum version 1.12)

Go version: go1.10.6

Git commit: 6247962

Built: Sun Feb 10 04:13:06 2019

OS/Arch: linux/amd64

Experimental: false

これでDockerを正しくインストールすることができました。

Docker-composeとは

Railsアプリの環境を構築するためには複数のコンテナが必要となります。

Docker-compose は、複数のコンテナから成るサービスを構築・実行する手順を自動的にし、管理を容易にする機能です。
composeファイルを用意してコマンドを1 回実行することで、そのファイルから設定を読み込んですべてのコンテナサービスを起動することができます。

必要なファイルを作成

プロジェクト用のディレクトリを作成し、そこに次の４つのファイルを作成する。

$ mkdir myapp
$ cd myapp

1 2	$ mkdir myapp $ cd myapp

◆dockerfile

FROM ruby:2.6.3
 
ENV LANG C.UTF-8
RUN apt-get update -qq && apt-get install -y build-essential libpq-dev nodejs
 
RUN mkdir /myapp
WORKDIR /myapp
ADD Gemfile /myapp/Gemfile
ADD Gemfile.lock /myapp/Gemfile.lock
RUN bundle install
COPY . /myapp
EXPOSE  3000

FROM ruby:2.6.3

ENV LANG C.UTF-8

RUN apt-get update -qq && apt-get install -y build-essential libpq-dev nodejs

RUN mkdir /myapp

WORKDIR /myapp

ADD Gemfile /myapp/Gemfile

ADD Gemfile.lock /myapp/Gemfile.lock

RUN bundle install

COPY . /myapp

EXPOSE 3000

◆Gemfile

source "https://rubygems.org"
gem 'rails', '5.2.2'

1 2	source "https://rubygems.org" gem 'rails', '5.2.2'

◆Gemfile.lock

※空のファイル

※空のファイル

◆docker-compose.yml

version: '3'
services:
  db:
    image: postgres
    volumes:
      - ./tmp/db:/var/lib/postgresql/data
    ports:
      - "5433:5432"
  web:
    build: .
    command: bundle exec rails s -p 3000 -b '0.0.0.0'
    volumes:
      - .:/myapp
    ports:
      - "3000:3000"
    depends_on:
      - db

version: '3'

services:

db:

image: postgres

volumes:

- ./tmp/db:/var/lib/postgresql/data

ports:

- "5433:5432"

web:

build: .

command: bundle exec rails s -p 3000 -b '0.0.0.0'

volumes:

- .:/myapp

ports:

- "3000:3000"

depends_on:

- db

プロジェクトの構築

先ほどの４つのファイルを読み込んで、Dockerコンテナ上にRailsアプリケーションが作成されます。

$ docker-compose run web rails new . --force --database=postgresql

1	$ docker-compose run web rails new . --force --database=postgresql

Docker imageの作成

$ docker-compose build

1	$ docker-compose build

データベースの設定と作成

◆config/database.yml

default: &default
  adapter: postgresql
  encoding: unicode
  host: db
  username: postgres
  password:
  pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
 
development:
  <<: *default
  database: myapp_development
 
test:
  <<: *default
  database: myapp_test

default: &default

adapter: postgresql

encoding: unicode

host: db

username: postgres

password:

pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>

development:

<<: *default

database: myapp_development

test:

<<: *default

database: myapp_test

DBを作成します。

$ docker-compose run web rails db:create

1	$ docker-compose run web rails db:create

Dockerコンテナの起動

Dockerコンテナが立ち上がり、Railsサーバーも起動します。

$ docker-compose up

1	$ docker-compose up

localhost:3000にアクセスしてブラウザで確認します。

次のコマンドで起動しているDockerのコンテナをチェックします。

$ docker container ls
CONTAINER ID        IMAGE               COMMAND                  CREATED              STATUS              PORTS                    NAMES
a2420008fdb0        myapp_web           "bundle exec rails s…"   55 seconds ago       Up 54 seconds       0.0.0.0:3000->3000/tcp   myapp_web_1
d76b74d2c2df        postgres            "docker-entrypoint.s…"   About a minute ago   Up About a minute   0.0.0.0:5432->5432/tcp   myapp_db_1

$ docker container ls

CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES

a2420008fdb0 myapp_web "bundle exec rails s…" 55 seconds ago Up 54 seconds 0.0.0.0:3000->3000/tcp myapp_web_1

d76b74d2c2df postgres "docker-entrypoint.s…" About a minute ago Up About a minute 0.0.0.0:5432->5432/tcp myapp_db_1

ちなみに、起動していないコンテナも表示するにはオプション指定 -a とします。

$ docker container ls -a
CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS                     PORTS                    NAMES
a2420008fdb0        myapp_web           "bundle exec rails s…"   2 minutes ago       Up 2 minutes               0.0.0.0:3000->3000/tcp   myapp_web_1
b3b036bf92da        myapp_web           "rails db:create"        3 minutes ago       Exited (0) 2 minutes ago                            myapp_web_run_97bb8be64543
d76b74d2c2df        postgres            "docker-entrypoint.s…"   3 minutes ago       Up 3 minutes               0.0.0.0:5432->5432/tcp   myapp_db_1

$ docker container ls -a

CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES

a2420008fdb0 myapp_web "bundle exec rails s…" 2 minutes ago Up 2 minutes 0.0.0.0:3000->3000/tcp myapp_web_1

b3b036bf92da myapp_web "rails db:create" 3 minutes ago Exited (0) 2 minutes ago myapp_web_run_97bb8be64543

d76b74d2c2df postgres "docker-entrypoint.s…" 3 minutes ago Up 3 minutes 0.0.0.0:5432->5432/tcp myapp_db_1

Dockerコンテナの停止

ショートカットの「Control + C」でコンテナが停止します。

よく使うコマンド

# foregroundで起動
$ docker-compose up

# backgroundで起動
$ docker-compose up -d

# 停止(foregroundで起動していた場合)
Ctr + C

# 停止(backgroundで起動していた場合)
$ docker-compose stop

# 再ビルド
$ docker-compose build

# DBを作成
$ docker-compose run web rails db:create

# マイグレーション
$ docker-compose run --rm web rails db:migrate

# コントローラー作成
$ docker-compose run --rm web rails controller <コントローラー名>

# モデルを作成
$ docker-compose run --rm web rails g model <モデル名> <カラム名:型>

# PostgreSQLへの接続
$ docker exec -it myapp_db_1 psql -U postgres -d myapp_development

# データのインポート
# dockerコンテナにアーカイブファイルを転送する
docker cp /Users/hirohiro/Downloads/latest0522.dump miraicle_db_1:/tmp
# PostgreSQLのコンテナ(db_1)にbashで入る
docker exec -it miraicle_db_1 bash
# コンテナ内でpg_restore実行
pg_restore --verbose --clean --no-acl --no-owner -U postgres -d miraicle_development tmp/latest0522.dump

# foregroundで起動

$ docker-compose up

# backgroundで起動

$ docker-compose up -d

# 停止(foregroundで起動していた場合)

Ctr + C

# 停止(backgroundで起動していた場合)

$ docker-compose stop

# 再ビルド

$ docker-compose build

# DBを作成

$ docker-compose run web rails db:create

# マイグレーション

$ docker-compose run --rm web rails db:migrate

# コントローラー作成

$ docker-compose run --rm web rails controller <コントローラー名>

# モデルを作成

$ docker-compose run --rm web rails g model <モデル名> <カラム名:型>

# PostgreSQLへの接続

$ docker exec -it myapp_db_1 psql -U postgres -d myapp_development

# データのインポート

# dockerコンテナにアーカイブファイルを転送する

docker cp /Users/hirohiro/Downloads/latest0522.dump miraicle_db_1:/tmp

# PostgreSQLのコンテナ(db_1)にbashで入る

docker exec -it miraicle_db_1 bash

# コンテナ内でpg_restore実行

pg_restore --verbose --clean --no-acl --no-owner -U postgres -d miraicle_development tmp/latest0522.dump

older > >

uncode アンコード