summaryrefslogtreecommitdiff
path: root/docs/reference/commandline/deploy.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/reference/commandline/deploy.md')
-rw-r--r--docs/reference/commandline/deploy.md20
1 files changed, 15 insertions, 5 deletions
diff --git a/docs/reference/commandline/deploy.md b/docs/reference/commandline/deploy.md
index 53074b2fd4..a430a90105 100644
--- a/docs/reference/commandline/deploy.md
+++ b/docs/reference/commandline/deploy.md
@@ -14,7 +14,9 @@ advisory: "experimental"
will be rejected.
-->
-# deploy (alias for stack deploy) (experimental)
+# deploy (experimental)
+
+An alias for `stack deploy`.
```markdown
Usage: docker deploy [OPTIONS] STACK
@@ -31,15 +33,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
@@ -54,8 +61,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
@@ -65,10 +73,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
@@ -82,6 +91,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
@@ -91,7 +101,7 @@ ID NAME MODE REPLICAS IMAGE
axqh55ipl40h vossibility_vossibility-collector replicated 1/1 icecrime/vossibility-collector@sha256:f03f2977203ba6253988c18d04061c5ec7aab46bca9dfd89a9a1fa4500989fba
```
-## Related information
+## Related commands
* [stack config](stack_config.md)
* [stack deploy](stack_deploy.md)