docker stack depoy

説明

【API 1.25+】このコマンドを使うには、クライアントとデーモン API の両方が、少なくとも 1.25 の必要があります。クライアントとデーモン API のバージョンを調べるには、 docker version コマンドを使います。

使い方

$ docker stack deploy [OPTIONS] STACK

補足説明

compose ファイルから読み込んだスタックを、 swarm 上に作成または更新します。

注釈

これはクラスタ管理コマンドであり、 swarm manager ノードで実行する必要があります。manager と worker について学ぶには、ドキュメント内の Swarm モードのセクション を参照ください。

コマンドの使用例は、以下の 使用例のセクション をご覧ください。

オプション

名前, 省略形 デフォルト 説明
--compose-file , -c   【API 1.25+】 Compose ファイルのパスか、 - で標準入力から読み込む
--namespaces   【deprecated】【Kubernetes】使用する Kubernetes 名前空間
--prune   【API 1.27+】【Swarm】参照されていないサービスを削除
--resolve-image always イメージのダイジェスト値とサポートしているプラットフォームを、レジストリに照会( always | changed | never
--with-registry-auth   【Swarm】Swarm エージェントにレジストリの認証情報を送信
--kubeconfig   【非推奨】【Kubernetes】Kubernetes 設定ファイル
--orchestrator   【非推奨】使用するオーケストレータ( swarm | kubernetes | all)

使用例

Compose ファイル

deploy コマンドは compose ファイル形式 3.0 以上をサポートします。

$ docker stack deploy --compose-file docker-compose.yml vossibility

Ignoring unsupported options: links

Creating network vossibility_vossibility
Creating network vossibility_default
Creating service vossibility_nsqd
Creating service vossibility_logstash
Creating service vossibility_elasticsearch
Creating service vossibility_kibana
Creating service vossibility_ghollector
Creating service vossibility_lookupd

また、 --compose-file - を使えば、Compose ファイルを標準入力経由でも指定できます。

$ cat docker-compose.yml | docker stack deploy --compose-file - vossibility

Ignoring unsupported options: links

Creating network vossibility_vossibility
Creating network vossibility_default
Creating service vossibility_nsqd
Creating service vossibility_logstash
Creating service vossibility_elasticsearch
Creating service vossibility_kibana
Creating service vossibility_ghollector
Creating service vossibility_lookupd

基本となる設定ファイルと、環境変数を上書きする設定ファイルのように、複数の Compose ファイルに設定が分割されている場合は、複数の --compose-file フラグを指定できます。

$ docker stack deploy --compose-file docker-compose.yml -c docker-compose.prod.yml vossibility

Ignoring unsupported options: links

Creating network vossibility_vossibility
Creating network vossibility_default
Creating service vossibility_nsqd
Creating service vossibility_logstash
Creating service vossibility_elasticsearch
Creating service vossibility_kibana
Creating service vossibility_ghollector
Creating service vossibility_lookupd

サービスが正しく作成されているかどうか、確認できます。

$ docker service ls

ID            NAME                               MODE        REPLICAS  IMAGE
29bv0vnlm903  vossibility_lookupd                replicated  1/1       nsqio/nsq@sha256:eeba05599f31eba418e96e71e0984c3dc96963ceb66924dd37a47bf7ce18a662
4awt47624qwh  vossibility_nsqd                   replicated  1/1       nsqio/nsq@sha256:eeba05599f31eba418e96e71e0984c3dc96963ceb66924dd37a47bf7ce18a662
4tjx9biia6fs  vossibility_elasticsearch          replicated  1/1       elasticsearch@sha256:12ac7c6af55d001f71800b83ba91a04f716e58d82e748fa6e5a7359eed2301aa
7563uuzr9eys  vossibility_kibana                 replicated  1/1       kibana@sha256:6995a2d25709a62694a937b8a529ff36da92ebee74bafd7bf00e6caf6db2eb03
9gc5m4met4he  vossibility_logstash               replicated  1/1       logstash@sha256:2dc8bddd1bb4a5a34e8ebaf73749f6413c101b2edef6617f2f7713926d2141fe
axqh55ipl40h  vossibility_vossibility-collector  replicated  1/1       icecrime/vossibility-collector@sha256:f03f2977203ba6253988c18d04061c5ec7aab46bca9dfd89a9a1fa4500989fba

親コマンド

コマンド 説明
docker stack Docker stack を管理

関連コマンド

コマンド 説明
docker stack deploy 新しいスタックをデプロイするか、既存のスタックを更新
docker stack ls スタックを一覧表示
docker stack ps スタック内のタスクを一覧表示
docker stack rm 1つまたは複数スタックを削除
docker stack services タスク内のサービスを一覧表示