Go bindings for Apache Mesos

Very early version of a pure Go language bindings for Apache Mesos. As with other pure implementation, mesos-go uses the HTTP wire protocol to communicate directly with a running Mesos master and its slave instances. One of the objectives of this project is to provide an idiomatic Go API that makes it super easy to create Mesos frameworks using Go.

![GoDoc] (https://godoc.org/github.com/mesos/mesos-go?status.png)

Current Status

This is a very early version of the project. Howerver, here is a list of things that works so far:

• The SchedulerDriver API implemented
• The ExecutorDriver API implemented
• Stable API (based on the core Mesos code)
• Plenty of unit and integrative of tests
• Modular design for easy readability/extensibility
• Example programs on how to use the API
• Leading master detection
• Authentication via SASL/CRAM-MD5

Pre-Requisites

• Go 1.3 or higher
• A standard and working Go workspace setup
• Apache Mesos 0.19 or newer
• godep

Optional

• Install Protocol Buffer tools 2.5 locally - See http://code.google.com/p/protobuf/
• GNU Make

Build Instructions

The following instructions is to build the code from github.The project uses the GoDep for dependency management.

$ cd <go-workspace>/src/
$ mkdir -p github.com/mesos
$ cd github.com/mesos
$ git clone https://github.com/mesos/mesos-go.git
$ cd mesos-go
$ go get github.com/tools/godep
$ godep restore
$ go build ./...

The previous will build the code base.

Building the Examples

Use the following steps to build the example scheduler and executor:

$ cd <go-workspace>/src/github.com/mesos/mesos-go/examples

# build example-scheduler
$ go build -tags=example-sched -o example-scheduler example_scheduler.go

Or by using the top level Makefile:

$ cd <go-workspace>/src/github.com/mesos/mesos-go

# build example-scheduler
$ make example-scheduler

Running the Example

Start Mesos

You will need a running Mesos master and slaves to run the examples. For instance, start a local Mesos:

$ <mesos-build-install>/bin/mesos-local --ip=127.0.0.1 --port=5050

See http://mesos.apache.org/gettingstarted/ for getting started with Apache Mesos.

Running the Go Scheduler Examples

This scheduler example will schedule Docker containers, and the image name and count (default 5) need be passed.

$ cd <go-workspace>/src/github.com/mesos/mesos-go
$ cd examples
$ ./example-scheduler —-master=127.0.0.1:5050 —-image=centos6:latest --task-count=3 --logtostderr=true

Note: If all goes well, you should see output about task completion. You can also point your browser to the Mesos GUI http://127.0.0.1:5050/ to validate the framework activities.