Docker Clustering: Design proposal.

Authors: @aluzzardi and @vieux.

[![ScreenShot](http://cl.ly/image/2j0S0Y3h0y3o/Screen%20Shot%202014-10-30%20at%2017.23.38.png)](https://www.youtube.com/watch?v=vtnSL79rZ6o)

The goal and scope of this change is to allow docker to manage a cluster
of docker hosts.

The target audience for clustering is modeled after Docker itself:
developer and devops first then enterprise later. Enterprise requires
additional features such as authentication, ACLs, auditing and tooling
which will come at a later time.

The system is designed to handle workloads in the same way as Docker: it
can run both long-running and one-off tasks. Batch processing can be
built on top of the API using the one-off primitive.

The architecture is based on an evented model where the master queries
the registered slaves within the system and checks the current state of
the slaves against the requested state by the user.  It reconciles any
differences and updates the cluster state with the required changes.

Signed-off-by: Andrea Luzzardi <aluzzardi@gmail.com>
Signed-off-by: Victor Vieux <vieux@docker.com>
No, the discovery mechanism is only for discovering docker hosts. Considerations around container and where they are run is job of the master. Whether the master replicates the state to other docker hosts for failover etc is still up for discussion but likely necessary.