docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #367 from aluzzardi/docs-update-official-image 

Docs: Run swarm using the docker official image in the examples.
This commit is contained in:
Victor Vieux 2015-02-10 11:58:20 -08:00
parent df3a80db5b 6ea7c707e9
commit e256ef2b45
2 changed files with 28 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
README.md
View File

@ -17,17 +17,28 @@ in more powerful backends, like `Mesos`, for large scale production deployments.
## Installation ## Installation
###1 - Download and install the current source code. ###1 - Docker image.
The easiest way to get started with Swarm is to use the
[official Docker image](https://registry.hub.docker.com/_/swarm/).
```sh
docker pull swarm
```
###2 - Alternative: Download and install from source.
Alternatively, you can download and install from source instead of using the
Docker image.
Ensure you have golang and git client installed (e.g. `apt-get install golang git` on Ubuntu). Ensure you have golang and git client installed (e.g. `apt-get install golang git` on Ubuntu).
You may need to set `$GOPATH`, e.g `mkdir ~/gocode; export GOPATH=~/gocode`. You may need to set `$GOPATH`, e.g `mkdir ~/gocode; export GOPATH=~/gocode`.
The install `swarm` binary to your `$GOPATH` directory. The install `swarm` binary to your `$GOPATH` directory.
```sh ```bash
go get -u github.com/docker/swarm go get -u github.com/docker/swarm
``` ```
###2 - Nodes setup ###3 - Nodes setup
The only requirement for Swarm nodes is to run a regular Docker daemon (version The only requirement for Swarm nodes is to run a regular Docker daemon (version
`1.4.0` and later). `1.4.0` and later).
@ -39,16 +50,16 @@ network interface. This can be achieved by starting Docker with the `-H` flag
```bash ```bash
# create a cluster # create a cluster
$ swarm create $ docker run --rm swarm create
6856663cdefdec325839a4b7e1de38e8 # <- this is your unique <cluster_id> 6856663cdefdec325839a4b7e1de38e8 # <- this is your unique <cluster_id>
# on each of your nodes, start the swarm agent # on each of your nodes, start the swarm agent
# <node_ip> doesn't have to be public (eg. 192.168.0.X), # <node_ip> doesn't have to be public (eg. 192.168.0.X),
# as long as the swarm manager can access it. # as long as the swarm manager can access it.
$ swarm join --addr=<node_ip:2375> token://<cluster_id> $ docker run -d swarm join --addr=<node_ip:2375> token://<cluster_id>
# start the manager on any machine or your laptop # start the manager on any machine or your laptop
$ swarm manage -H tcp://<swarm_ip:swarm_port> token://<cluster_id> $ docker run -t -p 2375:<swarm_port> -t swarm manage token://<cluster_id>
# use the regular docker cli # use the regular docker cli
$ docker -H tcp://<swarm_ip:swarm_port> info $ docker -H tcp://<swarm_ip:swarm_port> info
@ -58,7 +69,7 @@ $ docker -H tcp://<swarm_ip:swarm_port> logs ...
... ...
# list nodes in your cluster # list nodes in your cluster
$ swarm list token://<cluster_id> $ docker run --rm swarm list token://<cluster_id>
<node_ip:2375> <node_ip:2375>
``` ```

27
userguide.md
View File

@ -26,18 +26,11 @@ in more powerful backends, like `Mesos`, for large scale production deployments.
> Docker daemon (version `1.4.0` and later), configured to listen to a `tcp` > Docker daemon (version `1.4.0` and later), configured to listen to a `tcp`
> port that the Swarm manager can access. > port that the Swarm manager can access.
Docker `swarm` is currently only available as a single go binary on Linux. Download The easiest way to get started with Swarm is to use the
it from [the latest release](https://github.com/docker/swarm/releases/latest) page [official Docker image](https://registry.hub.docker.com/_/swarm/).
on GitHub.
For example: ```bash
docker pull swarm
```
$ wget -O swarm https://github.com/docker/swarm/releases/download/v0.1.0-rc1/swarm-Linux-x86_64
# OR
$ curl -SsL https://github.com/docker/swarm/releases/download/v0.1.0-rc1/swarm-Linux-x86_64 > swarm
$ chmod 755 swarm
$ sudo cp swarm /usr/local/bin
``` ```
## Nodes setup ## Nodes setup
@ -50,16 +43,16 @@ The following example uses the Docker Hub based `token` discovery service:
```bash ```bash
# create a cluster # create a cluster
$ swarm create $ docker run --rm swarm create
6856663cdefdec325839a4b7e1de38e8 # <- this is your unique <cluster_id> 6856663cdefdec325839a4b7e1de38e8 # <- this is your unique <cluster_id>
# For each of your nodes, start a swarm agent # on each of your nodes, start the swarm agent
# the Docker daemon <node_ip> doesn't have to be public (eg. 192.168.0.X), # <node_ip> doesn't have to be public (eg. 192.168.0.X),
# as long as the swarm manager can access it. # as long as the swarm manager can access it.
$ swarm join --addr=<node_ip:2375> token://<cluster_id> $ docker run -d swarm join --addr=<node_ip:2375> token://<cluster_id>
# start the manager on any machine or your laptop # start the manager on any machine or your laptop
$ swarm manage -H tcp://<swarm_ip:swarm_port> token://<cluster_id> $ docker run -t -p 2375:<swarm_port> -t swarm manage token://<cluster_id>
# use the regular docker cli # use the regular docker cli
$ docker -H tcp://<swarm_ip:swarm_port> info $ docker -H tcp://<swarm_ip:swarm_port> info
@ -69,7 +62,7 @@ $ docker -H tcp://<swarm_ip:swarm_port> logs ...
... ...
# list nodes in your cluster # list nodes in your cluster
$ swarm list token://<cluster_id> $ docker run --rm swarm list token://<cluster_id>
<node_ip:2375> <node_ip:2375>
``` ```