mirror of https://github.com/docker/docs.git
99 lines
4.0 KiB
Markdown
99 lines
4.0 KiB
Markdown
---
|
|
description: Setup for voting app example
|
|
keywords: multi-container, services, swarm mode, cluster, voting app, docker-stack.yml, docker stack deploy
|
|
title: Deploy the application
|
|
---
|
|
|
|
In these steps, you'll use the `docker-stack.yml` file to
|
|
deploy the voting application to the swarm you just created.
|
|
|
|
## Copy docker-stack.yml to the manager
|
|
|
|
The `docker-stack.yml` file must be located on a manager for the swarm where you want to deploy the application stack.
|
|
|
|
1. Get `docker-stack.yml` either from the [source code in the lab](https://github.com/docker/example-voting-app/blob/master/docker-stack.yml) or by copying it from the example given [here](index.md#docker-stackyml-deployment-configuration-file).
|
|
|
|
If you prefer to download the file directly from our GitHub
|
|
repository rather than copy it from the documentation, you can use a tool like `curl`. This command downloads the raw file to the current directory on your local host. You can copy-paste it into your shell if you have `curl`:
|
|
|
|
```
|
|
curl -o docker-stack.yml https://raw.githubusercontent.com/docker/example-voting-app/master/docker-stack.yml
|
|
```
|
|
|
|
>**Tips:**
|
|
>
|
|
* To get the URL for the raw file on GitHub, either use the link in the example command above, or go to the file on GitHub [here](https://github.com/docker/example-voting-app/blob/master/docker-stack.yml), then click **Raw** in the upper right.
|
|
* You might already have `curl` installed. If not, you can [get curl here](https://curl.haxx.se/).
|
|
|
|
2. Copy `docker-stack.yml` from your host machine onto the manager.
|
|
|
|
```
|
|
$ docker-machine scp ~/sandbox/voting-app/docker-stack.yml manager:/home/docker/.
|
|
docker-stack.yml 100% 1558 1.5KB/s 00:00
|
|
```
|
|
|
|
3. Log into the manager node.
|
|
|
|
```
|
|
$ docker-machine ssh manager
|
|
```
|
|
|
|
The `ssh` login should put you in `/home/docker/` by default.
|
|
|
|
4. Check to make sure that the `.yml` file is there, using `ls`.
|
|
|
|
```
|
|
docker@manager:~$ ls /home/docker/
|
|
docker-stack.yml
|
|
```
|
|
|
|
You can use `vi` or `cat` to inspect the file.
|
|
|
|
## Deploy the app
|
|
|
|
We'll deploy the application from the manager.
|
|
|
|
1. Deploy the application stack based on the `.yml` using the command
|
|
[`docker stack deploy`](/engine/reference/commandline/stack_deploy.md) as follows.
|
|
|
|
```
|
|
docker stack deploy --compose-file docker-stack.yml vote
|
|
```
|
|
|
|
* The `--compose-file` option specifies the path to our stack file. In this case, we assume it's in the current directory so we simply name the stack file: `docker-stack.yml`.
|
|
|
|
* For the example, we name this app `vote`, but we could name it anything we want.
|
|
|
|
Here is an example of the command and the output.
|
|
|
|
```
|
|
docker@manager:~$ docker stack deploy --compose-file docker-stack.yml vote
|
|
Creating network vote_default
|
|
Creating network vote_backend
|
|
Creating network vote_frontend
|
|
Creating service vote_result
|
|
Creating service vote_worker
|
|
Creating service vote_visualizer
|
|
Creating service vote_redis
|
|
Creating service vote_db
|
|
Creating service vote_vote
|
|
```
|
|
|
|
2. Verify that the stack deployed as expected with `docker stack services <APP-NAME>`.
|
|
|
|
```
|
|
docker@manager:~$ docker stack services vote
|
|
ID NAME MODE REPLICAS IMAGE
|
|
1zkatkq7sf8n vote_result replicated 1/1 dockersamples/examplevotingapp_result:after
|
|
hphnxyt93h42 vote_redis replicated 2/2 redis:alpine
|
|
jd0wafumrcil vote_vote replicated 2/2 dockersamples/examplevotingapp_vote:after
|
|
msief4cqme29 vote_visualizer replicated 1/1 dockersamples/visualizer:stable
|
|
qa6y8sfmtjoz vote_db replicated 1/1 postgres:9.4
|
|
w04bh1vumnep vote_worker replicated 1/1 dockersamples/examplevotingapp_worker:latest
|
|
```
|
|
|
|
## What's next?
|
|
|
|
In the next steps, we'll view components of the running app
|
|
on web pages, and [take the app for a test drive](test-drive.md).
|