この記事では初めての人向けにdocker-composeの使い方を説明します。
Docker自体の概念やDockerfileの書き方についてはDockerの基本的な使い方を参考にしていただけると嬉しいです。
docker-composeを使ってDockerをより便利に使えるようになることを目標にします。

1. 概要

docker-composeは複数のdockerイメージやdockerコンテナを自動的に扱ったり、Dockerコマンドで設定することをまとめて実行させる機能になります。
このときに、設定を書くファイルをdocker-compose.ymlと言います。

2. docker-composeを使うメリット

概要でも書きましたが、docker-composeを使う主なメリットは

dockerコマンドの自動化
複数のdockerイメージやdockerコンテナを扱いやすくする

になります。docker-compose.ymlに自動化の設定ファイルを書くことで基本的には一つのコマンドですべてを一度に実行できるようになります。また、複数のDockerイメージに対して書くことによって同時に複数のコンテナを扱うことができます。

3. docker-compose.ymlの書き方

ここでは、　docker-composeの設計図に当たるdocker-compose.ymlの書き方について簡単に説明します。
具体的にはDockerfileからdockerイメージをbuildする場合とdockerイメージをpullしてくる場合それぞれ分けてjupyter labをコンテナ内で作る場合を例として解説します。

Dockerfileを使う場合

下のサンプルコードを例として説明します。

初めにdocker-composeのバージョンをversion: の次に書きます。今回はバージョン"3"になります。
次に使うイメージをservice:の次に行にインデントを開けてサービスとしてecho:を設定します。ここのサービス名は自由に名前をつけて大丈夫です。
この次の行からインデントを開けてコマンドを設定していきます。
1. build: ;ここはdockerコマンドdocker build以下に対応します。Dockerfileの名前を"Dockerfile"としたときにはDockerfileがあるPathを、他の名前をつけた場合にはPathとファイル名を書きます。
2. ports: ;ここにはdocker run -pに対応する情報を書きます。外部のport番号:コンテナ内のポート番号の順番で設定します。
3. volumes: ;ここにはdocker run -vに対応する情報を書きます。これはコンテナの外部の./code以下のコードがコンテナの内部の/code以下と対応させています。

docker-compose.yml

version: "3"
services:
  echo:
    build: .
    ports:
      - 8889:8888
    volumes:
      - ./code:/code

docker hubを使う場合

こちらも基本的には上記の場合と大体同じになります。違う点だけ説明していきます。

image: ;ここにはdocker pull 以下に対応します。このサンプルではhttps://hub.docker.com/r/jupyter/datascience-notebookからdockerイメージをpullしています。
environment: ;ここにはコンテナ内の環境変数を設定します。
command: ;ここにはdocker runをしたときに最後に実行されるコマンドを書きます。

docker-compose.yml


version: "3"
services:
  notebook:
    # https://hub.docker.com/r/jupyter/datascience-notebookからimageをpullする
    image: jupyter/datascience-notebook
    # ポートの設定("ホスト：コンテナ")
    ports:
      - "9999:8888"
    # 環境変数の設定
    environment:
      - JUPYTER_ENABLE_LAB=yes
    # ボリューム(データの永続化の場所)の設定(ホスト:コンテナ)
    # ホスト内のworkディレクトリとコンテナ内の/home/jovyan/workディレクトリが紐づいているイメージ
    volumes:
      - ./work:/home/jovyan/work
    # 最後にjupyterLabに接続するためのコマンドを実行する。
    command: start-notebook.sh --NotebookApp.token=''

4. docker-composeコマンド

`docker-compose up`

docker-composeがあるディレクトリでdockerイメージの作成・取得からdocker runまでをまとめて実行します。

オプション
- -b ：バックグラウンド実行
- --build ：コンテナを開始前にイメージを構築する

$ docker-compose up

`docker-compose down`

サービスを停止、削除をします。

$ docker-compose down

`docker-compose ps`

実行中のコンテナの一覧を表示します。

$ docker-compose down

`docker-compose log`

実行中のコンテナのログを表示します。

$ docker-compose log

5. おわりに

簡単にdocker-composeの使い方を説明をしてみました。
ここで紹介した以外のコマンドやdocker-compose.ymlの文法についてはDocumentを参考にしてください。

dockerの細かいコマンドをすべてdocker-compose upに置き換えることができるので大変便利な機能になります。
ぜひ、みなさん使ってみてください！

初めてのdocker-compose

目次

環境