Docker Compose チュートリアル

Docker Compose とは

Docker Compose とは複数のコンテナを利用して一つのサービスを提供する場合に YAML 一発で構築出来るようにするツール（という認識）で、以前は同様なツールで fig というツールがあったと記憶しているがこの fig がそのまま Docker Compose に名前を変えたようだ。

Fig has been replaced by Docker Compose, and is now deprecated. The new documentation is on the Docker website.

なるほど、なるほど。

---

準備

Docker Compose のインストール

現状は Docker Compose 自体のインストーラーは存在せず、以下のようにインストールするしかないようだ。

curl -L https://github.com/docker/compose/releases/download/1.3.2/docker-compose-`uname -s`-`uname -m` > docker-compose
sudo cp docker-compose /usr/local/bin/
sudo chmod +x /usr/local/bin/docker-compose

ヘルプ

$ docker-compose --help
Define and run multi-container applications with Docker.

Usage:
  docker-compose [options] [COMMAND] [ARGS...]
  docker-compose -h|--help

Options:
  -f, --file FILE           Specify an alternate compose file (default: docker-compose.yml)
  -p, --project-name NAME   Specify an alternate project name (default: directory name)
  --verbose                 Show more output
  -v, --version             Print version and exit

Commands:
  build              Build or rebuild services
  help               Get help on a command
  kill               Kill containers
  logs               View output from containers
  port               Print the public port for a port binding
  ps                 List containers
  pull               Pulls service images
  restart            Restart services
  rm                 Remove stopped containers
  run                Run a one-off command
  scale              Set number of containers for a service
  start              Start services
  stop               Stop services
  up                 Create and start containers
  migrate-to-labels  Recreate containers to add labels

---

チュートリアル

サンプル各種

• Get started with Django
• Get started with Rails
• Get started with Wordpress

とりあえず rails を

こちらを写経する。

まずは Dockerfile を作る。

FROM ruby:2.2.0
RUN apt-get update -qq && apt-get install -y build-essential libpq-dev
RUN mkdir /myapp
WORKDIR /myapp
ADD Gemfile /myapp/Gemfile
RUN bundle install
ADD . /myapp

Gemfile を作る。

source 'https://rubygems.org'
gem 'rails', '4.2.0'

docker-compose.yml を作る。

db:
  image: postgres
  ports:
    - "5432"
web:
  build: .
  command: bundle exec rails s -p 3000 -b '0.0.0.0'
  volumes:
    - .:/myapp
  ports:
    - "3000:3000"
  links:
    - db

一旦、rails new する。

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

docker-compose.yml には bundle exec rails s -p 3000 -b '0.0.0.0' と指定されているので、rails new . --force --database=postgresql --skip-bundle で上書きするイメージで処理が終了するとカレントディレクトリに以下のようにファイルが展開されている。

$ ls -l
total 68
-rw-rw-r-- 1 vagrant vagrant  178 Jul 18 12:20 Dockerfile
-rw-rw-r-- 1 vagrant vagrant 1480 Jul 18 12:21 Gemfile
-rw-r--r-- 1 root    root    3819 Jul 18 12:25 Gemfile.lock
-rw-r--r-- 1 root    root     478 Jul 18 12:26 README.rdoc
-rw-r--r-- 1 root    root     249 Jul 18 12:26 Rakefile
drwxr-xr-x 8 root    root    4096 Jul 18 12:26 app
drwxr-xr-x 2 root    root    4096 Jul 18 12:26 bin
drwxr-xr-x 5 root    root    4096 Jul 18 12:26 config
-rw-r--r-- 1 root    root     153 Jul 18 12:26 config.ru
drwxr-xr-x 2 root    root    4096 Jul 18 12:26 db
-rw-rw-r-- 1 vagrant vagrant  183 Jul 18 12:21 docker-compose.yml
drwxr-xr-x 4 root    root    4096 Jul 18 12:26 lib
drwxr-xr-x 2 root    root    4096 Jul 18 12:26 log
drwxr-xr-x 2 root    root    4096 Jul 18 12:26 public
drwxr-xr-x 8 root    root    4096 Jul 18 12:26 test
drwxr-xr-x 3 root    root    4096 Jul 18 12:26 tmp
drwxr-xr-x 3 root    root    4096 Jul 18 12:26 vendor

ちょっと Gemfile を修正。

gem 'therubyracer', platforms: :ruby

JavaScript の Runtime である therubyracer をインストールするようにアンコメントして最後に docker-compose build を実行する。

$ docker-compose build

以下のように出力される。

db uses an image, skipping
Building web...
Step 0 : FROM ruby:2.2.0
 ---> 51473a2975de
Step 1 : RUN apt-get update -qq && apt-get install -y build-essential libpq-dev
 ---> Using cache
 ---> 76dbd0c53ce1
Step 2 : RUN mkdir /myapp
 ---> Using cache
 ---> c263028a071e
Step 3 : WORKDIR /myapp
 ---> Using cache
 ---> 3172fc182c6c
Step 4 : ADD Gemfile /myapp/Gemfile
 ---> 6b9bcc9f7ccb
Removing intermediate container a5e6dcd92778
Step 5 : RUN bundle install
 ---> Running in 1482b35b5d74
Don't run Bundler as root. Bundler can ask for sudo if it is needed, and
installing your bundle as root will break this application for all non-root
users on this machine.
Fetching gem metadata from https://rubygems.org/.......

（略）

Installing uglifier 2.7.1
Installing web-console 2.2.1
Your bundle is complete!
It was installed into /usr/local/bundle
 ---> f30b4667c9f9
Removing intermediate container 1482b35b5d74
Step 6 : ADD . /myapp
 ---> 396b0def9cdf
Removing intermediate container e711c5b5248e
Successfully built 396b0def9cdf

config/database.yml を以下のように修正。

development: &default
  adapter: postgresql
  encoding: unicode
  database: postgres
  pool: 5
  username: postgres
  password:
  host: db

test:
  <<: *default
  database: myapp_test

最後にコンテナを起動する。

$ docker-compose up -d

-d でデタッチモード。以下のように出力される。

$ docker-compose up -d
Creating composerails_db_1...
Creating composerails_web_1...

docker logs で確認。

$ docker logs composerails_web_1 
=> Booting WEBrick
=> Rails 4.2.0 application starting in development on http://0.0.0.0:3000
=> Run `rails server -h` for more startup options
=> Ctrl-C to shutdown server
[2015-07-19 07:06:16] INFO  WEBrick 1.3.1
[2015-07-19 07:06:16] INFO  ruby 2.2.0 (2014-12-25) [x86_64-linux]
[2015-07-19 07:06:16] INFO  WEBrick::HTTPServer#start: pid=1 port=3000

ブラウザで確認。

おお。

---

少しひねる

Sinatra + Redis でなんちゃって API システム

こちらを参考させて頂いて、チョー簡単 API システムを作ってみたいと思う。

Dockerfile を作成、というか先ほどの Rails のものをそのまま。

FROM ruby:2.2.0
RUN apt-get update -qq && apt-get install -y build-essential
RUN mkdir /myapp
WORKDIR /myapp
ADD Gemfile /myapp/Gemfile
RUN bundle install
ADD . /myapp

docker-compose.yml を以下のように。

redis:
  image: redis
  ports:
    - "6379"
web:
  build: .
  command: bundle exec ruby app.rb -o 0.0.0.0
  volumes:
    - .:/myapp
  ports:
    - "14567:4567"
  links:
    - redis
  environment:
    - REDIS_HOST=redis

アプリケーション（app.rb）は以下のような簡単スクリプト。

#!/usr/bin/env ruby
#
require 'sinatra'
require 'redis'
require 'json'

r = Redis.new host: ENV["REDIS_HOST"], port:"6379"

get '/value/:key' do
  value = r.get params[:key]
  v = {
    key: params[:key],
    value: value
  }
  v.to_json
end

post '/data/:key' do
  msg = request.body.read
  r.set params[:key], msg
end

Gemfile は以下のように用意。

source 'https://rubygems.org'

gem "sinatra"
gem "redis"

docker-compose build でビルド。

$ docker-compose build

以下のように出力される。

Building web...
Step 0 : FROM ruby:2.2.0
 ---> 51473a2975de
Step 1 : RUN apt-get update -qq && apt-get install -y build-essential
 ---> Running in 8c1bc72000c3
Reading package lists...
Building dependency tree...
Reading state information...
build-essential is already the newest version.
The following package was automatically installed and is no longer required:
  libbison-dev
Use 'apt-get autoremove' to remove it.
0 upgraded, 0 newly installed, 0 to remove and 160 not upgraded.
 ---> 2ebb189c25b1
Removing intermediate container 8c1bc72000c3
Step 2 : RUN mkdir /myapp
 ---> Running in 3ae7afaa1941
 ---> f528a03f229b
Removing intermediate container 3ae7afaa1941
Step 3 : WORKDIR /myapp
 ---> Running in 114d4e12d4a6
 ---> 0cd25195c3ab
Removing intermediate container 114d4e12d4a6
Step 4 : ADD Gemfile /myapp/Gemfile
 ---> 33430f3a8848
Removing intermediate container c9333ca6b80b
Step 5 : RUN bundle install
 ---> Running in b3fac0dae84d
Don't run Bundler as root. Bundler can ask for sudo if it is needed, and
installing your bundle as root will break this application for all non-root
users on this machine.
Fetching gem metadata from https://rubygems.org/..........

（略）

Your bundle is complete!
It was installed into /usr/local/bundle
 ---> fd7d36d14b1e
Removing intermediate container b3fac0dae84d
Step 6 : ADD . /myapp
 ---> 5ab105adefab
Removing intermediate container 2b7359c7add1
Successfully built 5ab105adefab

docker-compose up -d でコンテナを起動。

$ docker-compose up -d
Creating composesinatra_redis_1...
Creating composesinatra_web_1...

各コンテナが起動していることを確認。

$ docker-compose ps
         Name                       Command               State            Ports          
-----------------------------------------------------------------------------------------
composesinatra_redis_1   /entrypoint.sh redis-server      Up      0.0.0.0:32845->6379/tcp 
composesinatra_web_1     bundle exec ruby app.rb -o ...   Up      0.0.0.0:14567->4567/tcp 

docker-compose logs で確認。

$ docker-compose logs web
Attaching to composesinatra_web_1
web_1 | [2015-07-19 07:29:10] INFO  WEBrick 1.3.1
web_1 | [2015-07-19 07:29:10] INFO  ruby 2.2.0 (2014-12-25) [x86_64-linux]
web_1 | == Sinatra (v1.4.6) has taken the stage on 4567 for development with backup from WEBrick
web_1 | [2015-07-19 07:29:10] INFO  WEBrick::HTTPServer#start: pid=1 port=4567

$ docker-compose logs redis
Attaching to composesinatra_redis_1
redis_1 | 1:C 19 Jul 07:29:09.431 # Warning: no config file specified, using the default config. In order to specify a config file use redis-server /path/to/redis.conf
redis_1 |                 _._                                                  
redis_1 |            _.-``__ ''-._                                             
redis_1 |       _.-``    `.  `_.  ''-._           Redis 3.0.3 (00000000/0) 64 bit
redis_1 |   .-`` .-```.  ```\/    _.,_ ''-._                                   
redis_1 |  (    '      ,       .-`  | `,    )     Running in standalone mode
redis_1 |  |`-._`-...-` __...-.``-._|'` _.-'|     Port: 6379
redis_1 |  |    `-._   `._    /     _.-'    |     PID: 1
redis_1 |   `-._    `-._  `-./  _.-'    _.-'                                   
redis_1 |  |`-._`-._    `-.__.-'    _.-'_.-'|                                  
redis_1 |  |    `-._`-._        _.-'_.-'    |           http://redis.io        
redis_1 |   `-._    `-._`-.__.-'_.-'    _.-'                                   
redis_1 |  |`-._`-._    `-.__.-'    _.-'_.-'|                                  
redis_1 |  |    `-._`-._        _.-'_.-'    |                                  
redis_1 |   `-._    `-._`-.__.-'_.-'    _.-'                                   
redis_1 |       `-._    `-.__.-'    _.-'                                       
redis_1 |           `-._        _.-'                                           
redis_1 |               `-.__.-'                                               
redis_1 | 
redis_1 | 1:M 19 Jul 07:29:09.432 # Server started, Redis version 3.0.3

以下のようにデータを登録。

$ curl -X POST 127.0.0.1:14567/data/foo -d 'bar'

以下のようにデータを取得。

$ curl -s -X GET 127.0.0.1:14567/value/foo | python -m json.tool
{
    "key": "foo",
    "value": "bar"
}

おお、簡単。

スケールアウト、スケールイン

以下のような状態。

$ docker-compose ps
         Name                       Command               State            Ports          
-----------------------------------------------------------------------------------------
composesinatra_redis_1   /entrypoint.sh redis-server      Up      0.0.0.0:32850->6379/tcp 
composesinatra_web_1     bundle exec ruby app.rb -o ...   Up      0.0.0.0:32852->4567/tcp

Web サーバーをプラスで 2 台増やしたいなあと思ったら docker-compose scale を利用すればさくっとスケールアウト、スケールインが出来る。

以下のように docker-compose.yml を修正する。

redis:
  image: redis
  ports:
    - "6379"
web:
  build: .
  command: bundle exec ruby app.rb -o 0.0.0.0
  volumes:
    - .:/myapp
  ports:
    - "4567"
  links:
    - redis
  environment:
    - REDIS_HOST=redis

以下のように docker-compose scale の引数に web=3 のようにサービスに台数を指定して実行する。

$ docker-compose scale web=3

以下のように出力される。

$ docker-compose scale web=3
Creating composesinatra_web_2...
Creating composesinatra_web_3...
Starting composesinatra_web_2...
Starting composesinatra_web_3...

確認。

$ docker-compose ps
         Name                       Command               State            Ports          
-----------------------------------------------------------------------------------------
composesinatra_redis_1   /entrypoint.sh redis-server      Up      0.0.0.0:32850->6379/tcp 
composesinatra_web_1     bundle exec ruby app.rb -o ...   Up      0.0.0.0:32852->4567/tcp 
composesinatra_web_2     bundle exec ruby app.rb -o ...   Up      0.0.0.0:32854->4567/tcp 
composesinatra_web_3     bundle exec ruby app.rb -o ...   Up      0.0.0.0:32855->4567/tcp

おお、増えとる。

$ docker-compose logs 
Attaching to composesinatra_web_3, composesinatra_web_2, composesinatra_web_1, composesinatra_redis_1
web_3   | [2015-07-19 07:58:56] INFO  WEBrick 1.3.1
web_3   | [2015-07-19 07:58:56] INFO  ruby 2.2.0 (2014-12-25) [x86_64-linux]
web_3   | == Sinatra (v1.4.6) has taken the stage on 4567 for development with backup from WEBrick
web_3   | [2015-07-19 07:58:56] INFO  WEBrick::HTTPServer#start: pid=1 port=4567
web_2   | [2015-07-19 07:58:56] INFO  WEBrick 1.3.1
web_2   | [2015-07-19 07:58:56] INFO  ruby 2.2.0 (2014-12-25) [x86_64-linux]
web_2   | == Sinatra (v1.4.6) has taken the stage on 4567 for development with backup from WEBrick
web_2   | [2015-07-19 07:58:56] INFO  WEBrick::HTTPServer#start: pid=1 port=4567

ちゃんと web_2 と web_3 が起動している。ぢゃあ、次に減らしてみる。

$ docker-compose scale web=1
Stopping composesinatra_web_3...
Stopping composesinatra_web_2...
Removing composesinatra_web_3...
Removing composesinatra_web_2...

$ docker-compose ps
         Name                       Command               State            Ports          
-----------------------------------------------------------------------------------------
composesinatra_redis_1   /entrypoint.sh redis-server      Up      0.0.0.0:32850->6379/tcp 
composesinatra_web_1     bundle exec ruby app.rb -o ...   Up      0.0.0.0:32852->4567/tcp

おお、サクッとコンテナが減ってる。

簡単にスケールインとスケールアウトが体験出来たけど...気になるのが外部に晒すポートを固定出来なくなる点をどうするか...。

---

ということで

参考

• Compose CLI reference
• docker-compose.yml reference
• Compose environment variables reference

簡単、便利

複数の Docker コンテナでサービスを起動しようとした時にコンテナ同士の IP やポート等を意識しなくても良いのは嬉しい（Docker Links をちゃんと理解出来ていないけど見事にそれをラッピングしてくれていると思う）。また、YAML で各サービス毎のコンテナを定義しておくことで docker-compose up 一発で起動出来るのも嬉しい限り。