https://github.com/deis/swarm
Swarm: a Docker-native clustering system
https://github.com/deis/swarm
Last synced: 5 months ago
JSON representation
Swarm: a Docker-native clustering system
- Host: GitHub
- URL: https://github.com/deis/swarm
- Owner: deis
- License: apache-2.0
- Fork: true (docker-archive/classicswarm)
- Created: 2015-04-23T20:01:55.000Z (about 11 years ago)
- Default Branch: nodefailover
- Last Pushed: 2015-05-09T00:39:18.000Z (about 11 years ago)
- Last Synced: 2024-06-20T16:44:32.747Z (almost 2 years ago)
- Language: Go
- Homepage:
- Size: 4.88 MB
- Stars: 0
- Watchers: 21
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Swarm: a Docker-native clustering system
[](https://godoc.org/github.com/docker/swarm)
[](https://travis-ci.org/docker/swarm)
[](https://coveralls.io/r/docker/swarm)
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](http://docs.docker.com/swarm/).
## 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:**
```bash
$ 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:**
```bash
$ brew install go
$ export GOPATH=~/go
$ export PATH=$PATH:~/go/bin
$ go get github.com/tools/godep
```
Then install the `swarm` binary:
```bash
$ 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](http://docs.docker.com/swarm/),
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](https://github.com/docker/swarm/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.