Skip to content

DNET_DockerCompose

Jump to bottom
nishi_74322014 edited this page Sep 11, 2026 · 1 revision

Dockerコンポーズ

概要

  • 複数コンテナの一括管理ができる機能。
  • Docker Composeファイル（docker-compose.yml）に定義する。
  • 既存のDockerイメージ（Dockerの該当節を参照）や
    Dockerファイルをインテグレーションする感じ。

ファイル

docker-compose.yml

概要（docker-compose.yml）

  • 基本的に、servicesに書くservices（コンテナ）を書く。
  • buildには、Dockerファイルを指定する。
  • imageには、Dockerイメージ（Dockerの該当節を参照）を指定する。
  • その他は、≒ docker container runコマンド（Dockerコマンドの該当節を参照）
    のオプション

機能

  • バージョン
Compose Engine
Compose 仕様 19.03.0
3.8 19.03.0
3.7 18.06.0
3.6 18.02.0
3.5 17.12.0
3.4 17.09.0
3.3 17.06.0
3.2 17.04.0
3.1 1.13.1
3.0 1.13.0
2.3 17.06.0
2.2 1.13.0
2.1 1.12.0
2.0 1.10.0
1.0 1.9.1

  • 機能

    • Dockerファイルによるイメージのビルド（build）

    • Dockerイメージ（Dockerの該当節を参照）の指定（image）

    • コンテナ内で動かすコマンドの指定（command/entrypoint）

    • コンテナ環境変数の指定（environment/env_file）

    • コンテナの情報設定（container_name/labels）

    • 入出力

      • コンテナ間の通信（ports/expose）
        ・portsは、ポートをホスト・マシンに公開する。基本的にはホスト側:コンテナ側と書く。
        ・exposeは、ポートを仮想ブリッジ（docker0）に公開する。コンテナのポートのみを書く。

      • コンテナのデータ設定（volumes/volumes_from）
        ・volumesは、ホスト・マシンのボリュームをマウントする。基本的にはホスト側:コンテナ側と書く。
        ・volumes_fromは、V3 で 削除されたが、networks
        　（Dockerのネットワーク設定の該当節を参照）のように、
        　volumesが使える。

    • ネットワーク（Dockerのネットワーク設定）

      • コンテナ間の依存関係（depends_on）
      • コンテナ間での連携（links）
        昨今、非推奨。networks を使用する。
        （いずれも Dockerのネットワーク設定の該当節を参照）

例（docker-compose.yml）

https://github.com/daisukenishino2/EvaluateAspNetCoreOnDocker/blob/master/WebApplication1/docker-compose.yml

docker-compose.override.yml

概要（docker-compose.override.yml）

  • 上書き用ファイルで、ローカル・デバックに必要な情報を集約するなどの用途で利用する。
  • K8sサービス用のイメージを作成する場合は、以下の様に明示して除外する。
>docker-compose -f docker-compose.yml build

例（docker-compose.override.yml）

https://github.com/daisukenishino2/EvaluateAspNetCoreOnDocker/blob/master/WebApplication1/docker-compose.override.yml

その他のファイル

docker-compose.dcproj

, etc.

リファレンス（Compose file）

Compose fileを参照。

build

https://docs.docker.jp/compose/compose-file.html#build

image

https://docs.docker.jp/compose/compose-file.html#image

command/entrypoint

environment/env_file

container_name/labels

ports/expose

「ホスト側:コンテナ側」と書けば安定。

「コンテナ側」と書く。

volumes/volumes_from

「ホスト側:コンテナ側」と書けば安定。

  • ホスト側を「.」とすると、docker-compose.ymlの位置にマウントされる。
  • なので、「./data:/data」などと書くと、解り易いと思われる。

links/depends_on

コマンド

  • 前述のように、基本は、カレントの、
    docker-composeファイルに記述の範囲のサービスに作用する。

  • カレント・ディレクトリの以下のdocker-composeファイルが対象

    • docker-compose.yml
    • docker-compose.yaml
    • docker-compose.override.yml
    • docker-compose.override.yaml

  • コマンドに

    • 「-f」を付与し、ファイルを明示することも可能。
    • 「--remove-orphans」を付与し、ファイルで定義されていないサービスを対象にする。

基本コマンド

バージョン確認

>C:\Users\nishi>docker-compose -v
docker-compose version 1.24.1, build 4667896b

確認

  • ps

    >docker-compose ps -q

    • 構文

      docker-compose ps [Option] [ServiceName...]

    • オプション

      • -q : ID のみ表示

  • logs

    >docker-compose logs

    • 構文

      docker-compose logs [Option] [ServiceName...]

    • オプション

      • --no-color : 白黒で画面に出力
      • --follow(-f) : ログの出力をフォロー（表示しつづける）
      • --timestamps(-t) : タイムスタンプの表示
      • --tail : 各コンテナのログの最終行から遡った行を表示

開始

>docker-compose up -d

※ -dを付与しない場合は、フォアグラウンドで動くので出力からデバッグなどが可能。

  • 構文

    docker-compose up [Option] [ServiceName...]

  • オプション

    • 実行（二者択一）

      • -d : バックグラウンドでコンテナを実行
      • --abort-on-container-exit : コンテナが１つでも停止したら全てのコンテナを停止

    • 再作成（二者択一）

      • --force-recreate : 変更がなくても、コンテナを再作成する
      • --no-recreate : コンテナが既に存在していれば、再作成しない

    • その他

      • --no-color : 白黒で画面に表示
      • --no-deps : リンクしたサービスを表示しない
      • --no-build : イメージが見つからなくてもbuild しない
      • --timeout(-t) TIMEOUT : 停止する時のタイムアウト秒数を指定 (デフォルト:10)
      • --remove-orphans : ファイルで定義されていないサービス用

停止

  • 通常の停止

    >docker-compose stop

    • 構文

      docker-compose stop [Option] [ServiceName...]

    • オプション

      • --timeout(-t) TIMEOUT : 停止する時のタイムアウト秒数を指定 (デフォルト:10)

  • 強制の停止

    >docker-compose kill -s SIGINT

    • 構文

      docker-compose kill [Option] [ServiceName...]

    • オプション

      • -s : コンテナに送信するシグナル。デフォルトのシグナルは SIGKILL

再開

>docker-compose start

  • 構文

    docker-compose start [ServiceName...]

  • オプション
    なし

再起動

>docker-compose restart

  • 構文

    docker-compose restart [Option] [ServiceName...]

  • オプション

    • --timeout(-t) TIMEOUT : 停止する時のタイムアウト秒数を指定 (デフォルト:10)

中断・再開

  • 中断

    >docker-compose pause

    • 構文

      docker-compose pause [ServiceName...]

    • オプション
      なし

  • 再開

    >docker-compose unpause

    • 構文

      docker-compose unpause [ServiceName...]

    • オプション
      なし

削除

  • 個別削除

    >docker-compose rm

    • 構文

      docker-compose rm [Option] [ServiceName...]

    • オプション

      • --force(-f) : 確認なく削除する
      • -v : アタッチしたアノニマス・ボリュームも削除
      • --all(-a) : docker-compose run で作成した一度だけのコンテナを全て削除

  • 全削除

    >docker-compose down

    • 構文

      docker-compose down [Option]

    • オプション

      • --rmi type : イメージの削除。type は'all' or 'local'
      • --volumes(-v) : 名前付きボリューム、アタッチしたアノニマス・ボリュームを削除
      • --remove-orphans : ファイルで定義していないサービス用のコンテナも削除

個別のコンテナ操作

コンテナ操作

>docker-compose run webapplication1 /bin/bash
root@041a67b9c5dc:/#

コンテナ構成の確認

  • 公開ポートの確認

    >docker-compose port webapplication1 80

    • 構文

      docker-compose port [Option] ServiceName Private_Port

    • オプション

      • --protocol=proto : tcp or udp [Default : tcp]
      • --index=index : コンテナのインデックス数 [Default : 1]

  • 構成の確認

    >docker-compose config

    • 構文

      docker-compose config [Option]

    • オプション

      • --quiet(-q) : 認証設定以外のメッセージを表示しない
      • --services : サービス名を1行で表示

コンテナのスケールアウト

>docker-compose up --scale webapplication1=3

  • 構文

    docker-compose up --scale [ServiceNameA=n...]

  • オプション
    なし

その他のコマンド

イメージのビルド

>docker-compose up --build

リファレンス（Compose command）

Compose commandを参照。

用例

以下が参考になる。

各種サービス

各種XXXXをDockerコンポーズ化する。

各種NoSQL編

各種NoSQLをDockerコンポーズ化する。

各種RDBMS編

各種RDBMSをDockerコンポーズ化する。

参考（各種サービス）

K8s連携

Kubernetesとの連携。

Kompose

Kompose

Compose on Kubernetes

Compose on Kubernetes

マイクロソフト系技術情報 Wiki

Docker for Windows

Docker for Windows

Visual Studio Tools for Docker

Visual Studio Tools for Docker

Visual Studio Kubernetes Tools

Visual Studio Kubernetes Tools

参考

docker.com

Compose

Compose file

Compose command

Qiita

さくらのナレッジ

移行メモ

  • 「削除」の個別削除の構文が docker-compose [Option] [ServiceName...] と サブコマンド名を欠いていたため、docker-compose rm [Option] [ServiceName...] に正した。
  • 「停止」「再起動」のオプション記載が -timeout(-t) となっていた箇所を 他と揃えて --timeout(-t) とした。
  • マイクロソフト系技術情報 Wiki（techinfoofmicrosofttech.osscons.jp）への リンクは、移行済みの MS_DockerForWindows / MS_VSToolsForDocker / MS_VSKubernetesTools に張り替えた。

Tags: 移行, Docker, Docker Compose, コンテナ, docker-compose.yml, Kubernetes

このWikiは「Open棟梁Project」,「OSSコンソーシアム 開発基盤部会」によって運営されています。

NetDevInfraWiki

マイクロソフト系技術情報 Wiki
Open 棟梁 Wiki

（未着手）

開発基盤部会 Wiki

移行管理: DONE ／ TODO

Clone this wiki locally