Source repo for Docker's Documentation
Go to file
Tom Kapanka 56626698fa Fix 404s that manifest in GitHub but not in the Docs site. Links should work in both.
Spoke with Mary (Moxiegirl) about this issue and it occurs because
when Docs is built, it pulls files from various places. This causes
the GitHub view to have broken links (and images) which isn't ideal
since people may come to the docs via either approach.

Signed-off-by: Tom Kapanka <tom@kapanka.com>
2015-03-25 20:45:19 -07:00
Godeps update Godeps 2015-03-17 17:41:46 -07:00
api do not leak dockerclient 2015-03-18 13:48:09 -07:00
cluster Merge pull request #446 from vieux/rmi 2015-03-24 16:04:35 -07:00
discovery Merge pull request #509 from vieux/nodes-discovery-gen 2015-03-24 17:00:48 -06:00
docs Fix 404s that manifest in GitHub but not in the Docs site. Links should work in both. 2015-03-25 20:45:19 -07:00
scheduler Modify documentation for soft constraints 2015-03-23 11:22:21 -06:00
script Enable coveralls. 2015-03-13 18:15:45 -07:00
state state: Store container ID in requested state. 2015-01-19 13:25:27 -08:00
test/integration Closes #501: Error if unknown args are used in create 2015-03-26 02:39:33 +00:00
version Bump version to 0.2.0 2015-03-23 14:56:45 -07:00
.gitignore improve locks 2014-11-18 23:04:11 +00:00
.godir update .godir 2014-11-18 21:47:00 +00:00
.travis.yml Enable coveralls. 2015-03-13 18:15:45 -07:00
CONTRIBUTING.md tweak workflow for godep update 2015-03-25 20:18:02 +07:00
Dockerfile Dockerfile: Set swarm to bind to all interfaces in container mode. 2015-02-02 18:44:22 -08:00
LICENSE use tcp:// in doc and update copyrights 2015-01-12 22:58:03 +00:00
README.md update ROADMAP.md and README.md 2015-03-18 16:30:54 -07:00
ROADMAP.md update ROADMAP.md and README.md 2015-03-18 16:30:54 -07:00
flags.go Add spread strategy and make it the default 2015-03-07 15:17:42 -08:00
help.go Use actual binary name instead of hardcoding it 2015-01-24 08:27:36 +00:00
join.go improve some logs 2015-01-26 23:41:56 +00:00
join_test.go allow hostnames in join 2015-01-16 01:47:38 +00:00
logo.png smaller logo 2014-12-03 11:47:55 +01:00
main.go Closes #501: Error if unknown args are used in create 2015-03-26 02:39:33 +00:00
manage.go remove mesos.go to move it to it's own PR 2015-02-27 14:25:50 -08:00

README.md

Swarm: a Docker-native clustering system

Build Status Coverage Status

Docker Swarm Logo

Docker Swarm is native clustering for Docker. It turns a pool of Docker hosts into a single, virtual host.

Swarm serves the standard Docker API, so any tool which already communicates with a Docker daemon can use Swarm to transparently scale to multiple hosts: Dokku, Compose, Krane, Flynn, Deis, DockerUI, Shipyard, Drone, Jenkins... and, of course, the Docker client itself.

Like other Docker projects, Swarm follows the "batteries included but removable" principle. It ships with a set of simple scheduling backends out of the box, and as initial development settles, an API will be developed to enable pluggable backends. The goal is to provide a smooth out-of-the-box experience for simple use cases, and allow swapping in more powerful backends, like Mesos, for large scale production deployments.

Installation and documentation

Full documentation is available here.

Development installation

You can download and install from source instead of using the Docker image.

Ensure you have golang, godep and git client installed. For example, on Ubuntu you'd run:

apt-get install golang git
go get github.com/tools/godep

You may need to set $GOPATH, e.g mkdir ~/gocode; export GOPATH=~/gocode.

Then install the swarm binary:

git clone https://github.com/docker/swarm
cd swarm
godep go install .

From here, you can follow the instructions in the main documentation, replacing docker run swarm with just swarm.

Participating

We welcome pull requests and patches; come say hi on IRC, #docker-swarm on freenode.

Our planning process and release cycle are detailed on the wiki

Creators

Andrea Luzzardi

Victor Vieux

Code and documentation copyright 2014-2015 Docker, inc. Code released under the Apache 2.0 license.

Docs released under Creative commons.