github.com/docker/docker-ce@v17.12.1-ce-rc2+incompatible/components/cli/docs/reference/commandline/stack_deploy.md (about) 1 --- 2 title: "stack deploy" 3 description: "The stack deploy command description and usage" 4 keywords: "stack, deploy, up" 5 --- 6 7 <!-- This file is maintained within the docker/cli GitHub 8 repository at https://github.com/docker/cli/. Make all 9 pull requests against that repo. If you see this file in 10 another repository, consider it read-only there, as it will 11 periodically be overwritten by the definitive file. Pull 12 requests which include edits to this file in other repositories 13 will be rejected. 14 --> 15 16 # stack deploy 17 18 ```markdown 19 Usage: docker stack deploy [OPTIONS] STACK 20 21 Deploy a new stack or update an existing stack 22 23 Aliases: 24 deploy, up 25 26 Options: 27 --bundle-file string Path to a Distributed Application Bundle file 28 -c, --compose-file string Path to a Compose file 29 --help Print usage 30 --prune Prune services that are no longer referenced 31 --resolve-image string Query the registry to resolve image digest and supported platforms 32 ("always"|"changed"|"never") (default "always") 33 --with-registry-auth Send registry authentication details to Swarm agents 34 ``` 35 36 ## Description 37 38 Create and update a stack from a `compose` or a `dab` file on the swarm. This command 39 has to be run targeting a manager node. 40 41 ## Examples 42 43 ### Compose file 44 45 The `deploy` command supports compose file version `3.0` and above. 46 47 ```bash 48 $ docker stack deploy --compose-file docker-compose.yml vossibility 49 50 Ignoring unsupported options: links 51 52 Creating network vossibility_vossibility 53 Creating network vossibility_default 54 Creating service vossibility_nsqd 55 Creating service vossibility_logstash 56 Creating service vossibility_elasticsearch 57 Creating service vossibility_kibana 58 Creating service vossibility_ghollector 59 Creating service vossibility_lookupd 60 ``` 61 62 The Compose file can also be provided as standard input with `--compose-file -`: 63 64 ```bash 65 $ cat docker-compose.yml | docker stack deploy --compose-file - vossibility 66 67 Ignoring unsupported options: links 68 69 Creating network vossibility_vossibility 70 Creating network vossibility_default 71 Creating service vossibility_nsqd 72 Creating service vossibility_logstash 73 Creating service vossibility_elasticsearch 74 Creating service vossibility_kibana 75 Creating service vossibility_ghollector 76 Creating service vossibility_lookupd 77 ``` 78 79 Only a single Compose file is accepted. If your configuration is split between 80 multiple Compose files, e.g. a base configuration and environment-specific overrides, 81 you can combine these by passing them to `docker-compose config` with the `-f` option 82 and redirecting the merged output into a new file. 83 84 ```bash 85 $ docker-compose -f docker-compose.yml -f docker-compose.prod.yml config > docker-stack.yml 86 $ docker stack deploy --compose-file docker-stack.yml vossibility 87 88 Ignoring unsupported options: links 89 90 Creating network vossibility_vossibility 91 Creating network vossibility_default 92 Creating service vossibility_nsqd 93 Creating service vossibility_logstash 94 Creating service vossibility_elasticsearch 95 Creating service vossibility_kibana 96 Creating service vossibility_ghollector 97 Creating service vossibility_lookupd 98 ``` 99 100 You can verify that the services were correctly created: 101 102 ```bash 103 $ docker service ls 104 105 ID NAME MODE REPLICAS IMAGE 106 29bv0vnlm903 vossibility_lookupd replicated 1/1 nsqio/nsq@sha256:eeba05599f31eba418e96e71e0984c3dc96963ceb66924dd37a47bf7ce18a662 107 4awt47624qwh vossibility_nsqd replicated 1/1 nsqio/nsq@sha256:eeba05599f31eba418e96e71e0984c3dc96963ceb66924dd37a47bf7ce18a662 108 4tjx9biia6fs vossibility_elasticsearch replicated 1/1 elasticsearch@sha256:12ac7c6af55d001f71800b83ba91a04f716e58d82e748fa6e5a7359eed2301aa 109 7563uuzr9eys vossibility_kibana replicated 1/1 kibana@sha256:6995a2d25709a62694a937b8a529ff36da92ebee74bafd7bf00e6caf6db2eb03 110 9gc5m4met4he vossibility_logstash replicated 1/1 logstash@sha256:2dc8bddd1bb4a5a34e8ebaf73749f6413c101b2edef6617f2f7713926d2141fe 111 axqh55ipl40h vossibility_vossibility-collector replicated 1/1 icecrime/vossibility-collector@sha256:f03f2977203ba6253988c18d04061c5ec7aab46bca9dfd89a9a1fa4500989fba 112 ``` 113 114 ### DAB file 115 116 ```bash 117 $ docker stack deploy --bundle-file vossibility-stack.dab vossibility 118 119 Loading bundle from vossibility-stack.dab 120 Creating service vossibility_elasticsearch 121 Creating service vossibility_kibana 122 Creating service vossibility_logstash 123 Creating service vossibility_lookupd 124 Creating service vossibility_nsqd 125 Creating service vossibility_vossibility-collector 126 ``` 127 128 You can verify that the services were correctly created: 129 130 ```bash 131 $ docker service ls 132 133 ID NAME MODE REPLICAS IMAGE 134 29bv0vnlm903 vossibility_lookupd replicated 1/1 nsqio/nsq@sha256:eeba05599f31eba418e96e71e0984c3dc96963ceb66924dd37a47bf7ce18a662 135 4awt47624qwh vossibility_nsqd replicated 1/1 nsqio/nsq@sha256:eeba05599f31eba418e96e71e0984c3dc96963ceb66924dd37a47bf7ce18a662 136 4tjx9biia6fs vossibility_elasticsearch replicated 1/1 elasticsearch@sha256:12ac7c6af55d001f71800b83ba91a04f716e58d82e748fa6e5a7359eed2301aa 137 7563uuzr9eys vossibility_kibana replicated 1/1 kibana@sha256:6995a2d25709a62694a937b8a529ff36da92ebee74bafd7bf00e6caf6db2eb03 138 9gc5m4met4he vossibility_logstash replicated 1/1 logstash@sha256:2dc8bddd1bb4a5a34e8ebaf73749f6413c101b2edef6617f2f7713926d2141fe 139 axqh55ipl40h vossibility_vossibility-collector replicated 1/1 icecrime/vossibility-collector@sha256:f03f2977203ba6253988c18d04061c5ec7aab46bca9dfd89a9a1fa4500989fba 140 ``` 141 142 ## Related commands 143 144 * [stack ls](stack_ls.md) 145 * [stack ps](stack_ps.md) 146 * [stack rm](stack_rm.md) 147 * [stack services](stack_services.md)