Skip to content

gonkulator/swarm

This branch is 1697 commits behind docker-archive/classicswarm:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

b0cbaec · Jul 10, 2015
Jul 7, 2015
Jul 7, 2015
Jul 1, 2015
Jul 9, 2015
Jul 5, 2015
Jul 4, 2015
Jul 2, 2015
Jul 10, 2015
Jun 29, 2015
Apr 30, 2015
Jul 7, 2015
Jun 16, 2015
May 11, 2015
Nov 18, 2014
Jun 30, 2015
Mar 25, 2015
Jul 7, 2015
Jun 6, 2015
Jan 12, 2015
Jun 6, 2015
May 27, 2015
Dec 3, 2014
May 12, 2015

Repository files navigation

Swarm: a Docker-native clustering system

GoDoc 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 the 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.

For example, on Mac OS X you'd run:

$ brew install go
$ export GOPATH=~/go
$ export PATH=$PATH:~/go/bin
$ go get github.com/tools/godep

Then install the swarm binary:

$ mkdir -p $GOPATH/src/github.com/docker/
$ cd $GOPATH/src/github.com/docker/
$ 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

You can contribute to Docker Swarm in several different ways:

  • If you have comments, questions, or want to use your knowledge to help others, come join the conversation on IRC. You can reach us at #docker-swarm on Freenode.

  • To report a problem or request a feature, please file an issue

  • Of course, we welcome pull requests and patches. For information on making feature requests, follow the process suggested here.

Finally, if you want to see what we have for the future and learn more about our release cycles, all this information is detailed on the wiki

Creators

Andrea Luzzardi

Victor Vieux

Copyright and license

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

Docs released under Creative commons.

About

Swarm: a Docker-native clustering system

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 78.5%
  • Shell 21.5%