Updating Docker output and curl for sticky sessions #2150
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
ldez
added
area/documentation
area/provider/docker
status/2-needs-review
and removed
status/0-needs-triage
labels
ldez
suggested changes
Sep 20, 2017
docs/user-guide/swarm-mode.md
Outdated
| @@ -1,20 +1,24 @@ | |||
| # Docker Swarm (mode) cluster | |||
|
|
|||
| This section explains how to create a multi-host docker cluster with swarm mode using [docker-machine](https://docs.docker.com/machine) and how to deploy Træfik on it. | |||
| This section explains how to create a multi-host docker cluster with swarm mode | |||
There was a problem hiding this comment.
please don't split line: one sentence on line.
docs/user-guide/swarm-mode.md
Outdated
| Let's deploy Træfik as a docker service in our cluster. | ||
| The only requirement for Træfik to work with swarm mode is that it needs to run on a manager node — we are going to use a | ||
| [constraint](https://docs.docker.com/engine/reference/commandline/service_create/#/specify-service-constraints-constraint) for that. | ||
| Let's deploy Træfik as a docker service in our cluster. The only requirement for |
docs/user-guide/swarm-mode.md
Outdated
| ## Deploy your apps | ||
|
|
||
| We can now deploy our app on the cluster, here [whoami](https://github.com/emilevauge/whoami), a simple web server in Go. | ||
| We start 2 services, on the `traefik-net` network. | ||
| We can now deploy our app on the cluster, here |
docs/user-guide/swarm-mode.md
Outdated
| We'll demonstrate that later. | ||
|
|
||
| !!! note | ||
| If using `docker stack deploy`, there is [a specific way that the labels must be defined in the docker-compose file](https://github.com/containous/traefik/issues/994#issuecomment-269095109). | ||
| If using `docker stack deploy`, there is [a specific way that the labels |
docs/user-guide/swarm-mode.md
Outdated
| Repeat the following command multiple times and note that the Hostname changes each time as Traefik load balances each request against the 5 tasks: | ||
| ## Access to your `whoami0` through Træfik multiple times. | ||
|
|
||
| Repeat the following command multiple times and note that the Hostname changes |
docs/user-guide/swarm-mode.md
Outdated
| Traefik relies on a cookie to maintain stickyness so you'll need to test this with a browser. | ||
|
|
||
| First you need to add `whoami1.traefik` to your hosts file: | ||
| Because the sticky sessions require cookies to work, we used the |
docs/user-guide/swarm-mode.md
Outdated
| ``` | ||
|
|
||
| Now open your browser and go to http://whoami1.traefik/ | ||
| If you load the cookies file (`-b cookies.txt`) for the next request, you will |
docs/user-guide/swarm-mode.md
Outdated
|
|
||
| The cluster consists of: | ||
|
|
||
| - 3 servers | ||
| - 1 manager | ||
| - 2 workers | ||
| - 1 [overlay](https://docs.docker.com/engine/userguide/networking/dockernetworks/#an-overlay-network) network | ||
| (multi-host networking) | ||
| - 1 [overlay](https://docs.docker.com/engine/userguide/networking/dockernetworks/#an-overlay-network) |
There was a problem hiding this comment.
please don't split line: one sentence on line.
docs/user-guide/swarm-mode.md
Outdated
| ``` | ||
|
|
||
| !!! note | ||
| As Træfik is published, you can access it from any machine and not only the manager. | ||
| As Træfik is published, you can access it from any machine and not only the |
There was a problem hiding this comment.
please don't split line: one sentence on line.
|
Note: it's the documentation for Docker Swarm mode not for Docker Swarm. |
jtyr
force-pushed
the
jtyr-swarm_mode
branch
2 times, most recently
from
63712df
to
e1c01f2
Compare
ldez
force-pushed
the
jtyr-swarm_mode
branch
from
e1c01f2
to
b8f5796
Compare
traefiker
force-pushed
the
jtyr-swarm_mode
branch
from
b8f5796
to
3ec1b10
Compare
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
This PR is updating the Docker Swarm Mode documentation with examples created with latest version of Docker. It also updates the section describing the access via sticky session by using
curlcommand only instead of requiring to amend the/etc/hostsfile and perform the test via web browser.