Docker Composeとは #

複数のコンテナで構成されるアプリケーションを定義と実行するためのツールのこと.
Dockerとは切り離されてる.
Composeはアプリケーションのサービスをファイルで定義する.
Dockerコマンドと高い親和性があるため, 学習コストが比較的低い.
Swarmモードにサービスをデプロイできるオーケストレーション機能もある.
Reference: Docker Compose 徹底解説
GitHubリポジトリ: https://github.com/docker/compose

活用場面 #

利用者視点
docker-compose.ymlがあれば, すぐに何でも実行できる.
開発者視点
環境の再構築が簡単
バージョン違いの環境を作りやすい
1つのマシン上に, 複数の環境を立ち上げられやすい

適切に書かれたYAMLファイルさえあれば, 誰でも簡単に環境構築もアプリケーション実行もできるのが強み.

インストール #

https://docs.docker.com/compose/install/

docker-compose.ymlの書き方 #

services:(使うイメージ), networks:(使うネットワーク), volumes:(使うボリューム)を定義する.
docker-compose.ymlの書き方 -> Docker Compose - docker-compose.yml リファレンス

公式Reference #

Compose file version 3 reference

working directory指定 #

working_dirを使う.

version: '3'
services:
  angular:
    image: angular-first-app
    ports:
      - "4200:4200"
    volumes:
      - .:/usr/src/app
    working_dir: /usr/src/app/first-app
    command: ng serve --host=0.0.0.0

起動と停止 #

# 起動
docker-compose up
# ビルドして起動
docker-compose up --build
# バックグラウンドで起動
docker-compose up -d
# 停止
docker-compose down
# ボリュームも削除しつつ停止
docker-compose down -v

nginxとhttpd #

docker-composeを以下の様に書く.

# docker-compose.yml
version: '3'

services:
  proxy:
    image: nginx:latest # this will use the latest version of 1.13.x
    ports:
      - '80:80' # expose 80 on host and sent to 80 in container
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
  web:
    image: httpd:latest  # this will use httpd:latest

nginx.confを以下の様に書く.

# nginx.conf
server {

	listen 80;

	location / {

		proxy_pass         http://web;
		proxy_redirect     off;
		proxy_set_header   Host $host;
		proxy_set_header   X-Real-IP $remote_addr;
		proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
		proxy_set_header   X-Forwarded-Host $server_name;

	}
}

そして, 以下を実行する.

docker-compose up -d # デーモンでコンテナ群を起動
docker-compose ps # 動いてるコンテナ一覧が見られる
>           Name                   Command          State         Ports
> ----------------------------------------------------------------------------
> compose-sample-2_proxy_1   nginx -g daemon off;   Up      0.0.0.0:80->80/tcp
> compose-sample-2_web_1     httpd-foreground       Up      80/tcp
docker-compose down # コンテナ群を停止する

コード例: solareenlo/udemy-docker-mastery/compose-sample-2

DrupalとPostgreSQL #

docker-compose.ymlに以下を記述する.

# Drupal with PostgreSQL
#
# Access via "http://localhost:8081"
#   (or "http://$(docker-machine ip):8081" if using docker-machine)
#
# During initial Drupal setup,
# Database type: PostgreSQL
# Database name: postgres
# Database username: postgres
# Database password: passwd
# ADVANCED OPTIONS; Database host: postgres
# ADVANCED OPTIONS; Database port: 5432

version: '3.7'

services:
  drupal:
    image: drupal:8-apache
    ports:
      - 8081:80
    volumes:
      - drupal-modules:/var/www/html/modules
      - drupal-profiles:/var/www/html/profiles
      - drupal-themes:/var/www/html/themes
      - drupal-sites:/var/www/html/sites
    restart: always

  postgres:
    image: postgres:10
    environment:
      POSTGRES_PASSWORD: passwd
    restart: always

volumes:
  drupal-modules:
  drupal-profiles:
  drupal-themes:
  drupal-sites:

そして, 起動する.

docker-compose up -d # DrupalとPostgreSQLを起動
docker-compose ps # 起動してるか確認
>              Name                            Command               State          Ports
> -----------------------------------------------------------------------------------------------
> compose-assignment-1_drupal_1     docker-php-entrypoint apac ...   Up      0.0.0.0:8081->80/tcp
> compose-assignment-1_postgres_1   docker-entrypoint.sh postgres    Up      5432/tcp

任意のブラウザでlocalhost:8081を開くとDrupalが立ち上がってる.
設定値は以下.

Database type: PostgreSQL
Database name: postgres
Database username: postgres
Database password: passwd
ADVANCED OPTIONS; Database host: postgres
ADVANCED OPTIONS; Database port: 5432

そして, 停止する.

docker-compose down -v # volumeも一緒に削除.

コード例: solareenlo/udemy-docker-mastery/compose-assignment-1

Node.jsとRedix #

docker-compose.ymlに以下の様に書く.

# docker-compose.yml
version: '3'
services:
  redis-server:
    image: 'redis'
  node-app:
    build: .
    ports:
      - "8082:8082"

Dockerfileに以下の様に書く.

# Dockerfile
FROM node:alpine

WORKDIR '/app'

COPY package.json .
RUN npm install
COPY . .

CMD ["npm", "start"]

そして, 以下の様に実行する.

docker-compose up -d
# 任意のブラウザでlobalhost:8082を訪れると訪問回数を表示するサイトが表示される
docker-compose down

コード例: solareenlo/visits-docker-nodejs

複数のイメージを作る #

Dockerfileからカスタムnginxイメージを作成しつつ, カスタムnginxコンテナとhttpdコンテナを動かしている.

git clone git@github.com:solareenlo/udemy-docker-mastery.git
cd udemy-docker-mastery/compose-sample-3

docker-compose.ymlの中身は以下.

version: '2'
services:
  proxy:
    build:
      context: .
      dockerfile: nginx.Dockerfile
    image: custom-nginx
    ports:
      - '80:80'
  web:
    image: httpd
    volumes:
      - ./html:/usr/local/apache2/htdocs/

カスタムnginxのnginx.Dockerfileの中身は以下.

FROM nginx:1.13
COPY nginx.conf /etc/nginx/conf.d/default.conf

nginx.confの中身は以下.

server {
	listen 80;
	location / {
		proxy_pass         http://web;
		proxy_redirect     off;
		proxy_set_header   Host $host;
		proxy_set_header   X-Real-IP $remote_addr;
		proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
		proxy_set_header   X-Forwarded-Host $server_name;
	}
}

webコンテナで使っているhtmlディレクトリの中身はhttps://startbootstrap.com/template-overviews/agency/です.
そして, 起動する.

docker-compose up -d

localhost:80を開くとサイトが見られる.
そして, 停止する.

docker-compose down --rmi local

コード例: solareenlo/udemy-docker-mastery/compose-sample-3

dockerfileでカスタムイメージを作成しつつdocker-composeで動かす #

Dockerfileに下記を記入する.

FROM drupal:8-apache
RUN apt-get update && apt-get install -y git \
    && rm -rf /var/lib/apt/lists/*
WORKDIR /var/www/html/themes
RUN git clone --branch 8.x-3.x --single-branch --depth 1 https://git.drupal.org/project/bootstrap.git \
    && chown -R www-data:www-data bootstrap
WORKDIR /var/www/html

docker-compose.ymlに下記を記入する.

# Drupal with PostgreSQL
#
# Access via "http://localhost:8081"
#   (or "http://$(docker-machine ip):8081" if using docker-machine)
#
# During initial Drupal setup,
# Database type: PostgreSQL
# Database name: postgres
# Database username: postgres
# Database password: passwd
# ADVANCED OPTIONS; Database host: postgres
# ADVANCED OPTIONS; Database port: 5432

version: '3.7'

services:
  drupal:
    image: custom-drupal
    build: .
    ports:
      - 8081:80
    volumes:
      - drupal-modules:/var/www/html/modules
      - drupal-profiles:/var/www/html/profiles
      - drupal-themes:/var/www/html/themes
      - drupal-sites:/var/www/html/sites
    restart: always

  postgres:
    image: postgres:10
    environment:
      POSTGRES_PASSWORD: passwd
    volumes:
      - drupal-data:/var/lib/postgresql/data
    restart: always

volumes:
  drupal-modules:
  drupal-profiles:
  drupal-themes:
  drupal-sites:
  drupal-data:

そして, 下記を実行する.

dokcer-compose up -d

すると, 任意のブラウザでlocalhost:8081を開くとDrupalが走っていて,
設定値は以下を入力して,

Database type: PostgreSQL
Database name: postgres
Database username: postgres
Database password: passwd
ADVANCED OPTIONS; Database host: postgres
ADVANCED OPTIONS; Database port: 5432

ページのテーマをDockerfileで設定してダウンロードしてきたBootstrapに変えてみる.
停止するには,

docker-compose down

コード例: solareenlo/udemy-docker-mastery/compose-assignment-2

テストを行う #

以下のようにdocker-compose.ymlにtests項目を追加する.

# docker-compose.ymlの中身
version: '3'
services:
  web:
    build:
      context: .
      dockerfile: Dockerfile.dev
    ports:
      - "3001:3000"
    volumes:
      - /app/node_modules
      - .:/app
  tests:
    build:
      context: .
      dockerfile: Dockerfile.dev
    volumes:
      - /app/node_modules
      - .:/app
    command: ["npm", "run", "test"]

# Dockerfile.devの中身
FROM node:alpine

WORKDIR '/app'

COPY package.json .
RUN npm install

COPY . .

CMD ["npm", "run", "start"]

そして, 以下でビルドし, 実行する.

docker-compose up --build

テスト用のコードを変更すると, 標準出力で結果が出てくる.

コード例: frontend-docker-react

環境変数 #

以下のようにvariabeleName=valueと書けばコンテナの中で有効な環境変数になる.

environment:
  - REDIS_HOST=redis
  - REDIS_PORT=6378

以下のようにvariableNameとだけ書けばホストから環境変数を取ってきてコンテナの中で有効な環境変数になる.

environment:
  - REDIS_HOST

Referece:
Docker-Compose の変数定義について

volumes #

以下のようにパスをvolumesに指定するとボリュームとしてマウントしてくれる.

volumes
  - /path/to/filename

以下のようにホストのパス:コンテナのパスと書くとホストをマウントしてくれる.

volumes
  - host/path:./path/to/test

AWSで動かした例 #

solareenlo/complex-docker

Node.jsを動かした例 #

BretFisher/node-docker-good-defaults