docker stack deploy¶

説明 ¶

【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	タスク内のサービスを一覧表示