summaryrefslogtreecommitdiff
path: root/docs/reference/commandline/stack_deploy.md
diff options
context:
space:
mode:
authorMisty Stanley-Jones <misty@apache.org>2017-04-03 16:54:34 -0700
committerGitHub <noreply@github.com>2017-04-03 16:54:34 -0700
commit473c5701cb66403b0535a5c01845cb0f27fbeb47 (patch)
tree9a40326ad4b426655abca7377dc30da003847d4d /docs/reference/commandline/stack_deploy.md
parentce07fb6b0f1b8765b92022e45f96bd4349812e06 (diff)
parent71e6babfa2598669218177b5b429e873b7f35e8f (diff)
downloaddocker-1.13.x.tar.gz
Merge pull request #32332 from mstanleyjones/1.13.x1.13.x
Cherry-pick command-line ref improvements
Diffstat (limited to 'docs/reference/commandline/stack_deploy.md')
-rw-r--r--docs/reference/commandline/stack_deploy.md16
1 files changed, 12 insertions, 4 deletions
diff --git a/docs/reference/commandline/stack_deploy.md b/docs/reference/commandline/stack_deploy.md
index 037feaebd7..39456b7ffa 100644
--- a/docs/reference/commandline/stack_deploy.md
+++ b/docs/reference/commandline/stack_deploy.md
@@ -30,15 +30,20 @@ Options:
--with-registry-auth Send registry authentication details to Swarm agents
```
+## Description
+
Create and update a stack from a `compose` or a `dab` file on the swarm. This command
has to be run targeting a manager node.
-## Compose file
+## Examples
+
+### Compose file
The `deploy` command supports compose file version `3.0` and above."
```bash
$ docker stack deploy --compose-file docker-compose.yml vossibility
+
Ignoring unsupported options: links
Creating network vossibility_vossibility
@@ -53,8 +58,9 @@ Creating service vossibility_lookupd
You can verify that the services were correctly created
-```
+```bash
$ 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
@@ -64,10 +70,11 @@ ID NAME MODE REPLICAS IMAGE
axqh55ipl40h vossibility_vossibility-collector replicated 1/1 icecrime/vossibility-collector@sha256:f03f2977203ba6253988c18d04061c5ec7aab46bca9dfd89a9a1fa4500989fba
```
-## DAB file
+### DAB file
```bash
$ docker stack deploy --bundle-file vossibility-stack.dab vossibility
+
Loading bundle from vossibility-stack.dab
Creating service vossibility_elasticsearch
Creating service vossibility_kibana
@@ -81,6 +88,7 @@ You can verify that the services were correctly created:
```bash
$ 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
@@ -90,7 +98,7 @@ ID NAME MODE REPLICAS IMAGE
axqh55ipl40h vossibility_vossibility-collector replicated 1/1 icecrime/vossibility-collector@sha256:f03f2977203ba6253988c18d04061c5ec7aab46bca9dfd89a9a1fa4500989fba
```
-## Related information
+## Related commands
* [stack ls](stack_ls.md)
* [stack ps](stack_ps.md)