From 3f0c3bc1c769bbc76a40bfa86c2cbe627f80552b Mon Sep 17 00:00:00 2001
From: Victor Vieux <victorvieux@gmail.com>
Date: Thu, 11 Jun 2015 16:55:21 -0700
Subject: [PATCH] add getting started mesos

Signed-off-by: Victor Vieux <victorvieux@gmail.com>
---
 cluster/mesos/README.md | 50 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)
 create mode 100644 cluster/mesos/README.md

diff --git a/cluster/mesos/README.md b/cluster/mesos/README.md
new file mode 100644
index 0000000000..332c9172e0
--- /dev/null
+++ b/cluster/mesos/README.md
@@ -0,0 +1,50 @@
+# Using Docker Swarm and Mesos
+
+Swarm comes with a built-in scheduler that works with the swarm manager to schedule container resources. You can completly replace the built-in scheduler with a 3rd party scheduler. For example, you can replace it with the Mesos scheduler as described here.
+
+When using Docker Swarm and Mesos, you use the Docker client to ask the swarm
+manager to schedule containers. The swarm manager then schedules those
+containers on a Mesos cluster.
+
+## Prerequisites
+
+Each node in your swarm must run a Mesos slave. The slave must be capable of starting tasks in a Docker Container using the `--containerizer=docker` option.
+
+You need to configure two TCP ports on the slave. One port to listen for the swarm manager, for example 2375. And a second TCP port to listen for the Mesos master, for example 3375.
+
+## Start the Docker Swarm manager
+
+If you use a single Mesos master:
+
+```     
+docker run -d -p <swarm_port>:2375 -p 3375:3375 swarm manage -c mesos-experimental --cluster-opt mesos.address=<public_machine_ip> --cluster-opt mesos.port=3375 <mesos_master_ip>:<mesos_master:port>
+```
+
+If you use multiple Mesos masters:
+
+```
+docker run -d -p <swarm_port>:2375 -p 3375:3375 swarm manage -c mesos-experimental --cluster-opt mesos.address=<public_machine_ip> --cluster-opt mesos.port=3375 zk://<mesos_masters_url>
+```
+
+Once the manager is running, check your configuration by running `docker info` as follows:
+
+```
+docker -H tcp://<manager_ip:manager_port> info
+```
+
+For example, if you run the manager locally on your machine:
+
+```
+Containers: 0
+Offers: 2
+  Offer: 20150609-222929-1327399946-5050-14390-O6286
+     └ cpus: 2
+     └ mem: 1006 MiB
+     └ disk: 34.37 GiB
+     └ ports: 31000-32000
+  Offer: 20150609-222929-1327399946-5050-14390-O6287
+     └ cpus: 2
+     └ mem: 1006 MiB
+     └ disk: 34.37 GiB
+     └ ports: 31000-32000
+```