mesosphere-backup / open-docs

[DEPRECATED] Documentation for Mesosphere supported open source projects.

[DEPRECATED]

This is currently used only for publishing Mesos deb/rpm binaries and is owned by the Mesos Core Team.

Build is here: https://jenkins.mesosphere.com/service/jenkins/job/open-docs/

THE REST OF THE CONTENT IS DEPRECATED. FOR THE LATEST INFORMATION, SEE dcos.io.

This repository contains the Markdown files that comprise the Mesosphere open documentation site.

View on staging environment

After a few minutes, an automated build will deploy changes to master to the staging site.

Periodically these changes will be pushed to the production site.

Running this site locally

If you are developing against this site and wish to see a rendered version of your documentation locally.

1. Install RubyGems

2. Install Bundler

    sudo gem install bundler
   

3. Update bundler

    bundle update
   

4. Add the default gems from the root of the project (you may need libxml2 - see here for instructions)

    bundle install --path vendor/bundle
   

5. Run Jekyll from the root of the project

    # Run Jekyll and watch for changes
    bundle exec rake dev
   

6. View the site in your browser: http://localhost:4000

open-docs's Issues

Add doc on how to backup Mesos and Marathon

1. Backup /etc/mesos*
2. Backup /etc/default/mesos*
3. Backup /etc/marathon/*
4. Backup /etc/chronos/*
5. curl marathon-host:8080/v2/apps
6. Grab ZooKeeper data dir (see ZooKeeper backup instructions at http://zookeeper.apache.org/doc/r3.4.6/zookeeperAdmin.html)

Here's the rest of my email:

• Backup command-line parameters from "/etc/mesos_", "/etc/marathon/_", "/etc/chronos/*".
  For details on Mesos parameters, see http://mesos.apache.org/documentation/latest/configuration/
• Backup environment variables from "/etc/default/mesos*"
• For your running Marathon app configurations, just "curl :8080/v2/apps"
  There also may be some json templates laying around the home directory of the machine I launched them from (#12).
• Marathon stores state in ZooKeeper, so backup the ZK data dir (see ZooKeeper backup instructions at http://zookeeper.apache.org/doc/r3.4.6/zookeeperAdmin.html)
• The HDFS framework is changing rapidly, so I'd recommend you either (a) build the latest from https://github.com/mesosphere/hdfs or (b) install your favorite flavor of HDFS alongside Mesos and set the --hadoop_home variable on slaves.
• For Spark see http://spark.apache.org/docs/latest/running-on-mesos.html
• Jenkins was run in a Docker image through Marathon, so that json template should be covered above.
• We also did some tweaking of /etc/hosts and iptables, so make sure you mirror that in a new setup.
• Other things you may/may not want to backup include the task sandboxes/logs ("/tmp/mesos/"), Mesos logs ("/var/log/mesos/"), Marathon/Chronos logs ("/var/log/messages"), master's registry of cluster state (on masters in --work_dir, possibly "/var/lib/mesos"

Niklas adds:
The master and slave endpoints also codifies the command line flags and locations. Could also be worthwhile grabbing and parsing (as that will be the source of truth in the end).

Add doc on ACL/roles for resource management

Roles / frameworks for prod + stage env constrained to a specific rack or machine

Can not start mesos-master on centos 6.5

Install successful, but cant not start mesos-master

[root@localhost /]# sudo yum -y install mesos
Loaded plugins: fastestmirror, security
Setting up Install Process
Loading mirror speeds from cached hostfile
 * base: mirrors.cn99.com
 * epel: mirrors.ustc.edu.cn
 * extras: mirrors.163.com
 * updates: mirrors.163.com
Package mesos-1.0.1-2.0.96.centos65.x86_64 already installed and latest version
Nothing to do

[root@localhost /]# sudo stop mesos-slave
stop: Unknown instance:

[root@localhost /]# sudo restart mesos-master
restart: Unknown instance:

[root@localhost /]# sudo start mesos-master
start: Job failed to start

[root@localhost /]# which mesos-master
/usr/sbin/mesos-master

[root@localhost /]# ls -Al /usr/sbin/mesos-master
-rwxr-xr-x 1 root root 326033 Sep  7 20:08 /usr/sbin/mesos-master

Add doc on upgrading a Mesos cluster

Add doc on logging and monitoring a Mesos cluster

Create doc on production issues

Related to http://mesosphere.github.io/presentations/2015-08-17-deploying-containers-in-production-and-at-scale/containercon.pdf

Add doc on Mesos Architecture and Components

A high level document describing the Mesos architecture and what each of the components does.

Add DCOS to list of provisioning tools

Page: https://open.mesosphere.com/getting-started/tools/

Mesos-master starting, but command could't get executed completely?

I am new to Apache Mesos. For setting up local mode mesos I have followed the instruction specified here. The Mesos Master is starting and I am able to add agent too in another session in my putty. But it is showing something below

`[intern@SBSCLR03 build]$ ./bin/mesos-master.sh --ip=192.168.61.1 --work_dir=/home/intern/mesos
WARNING: Logging before InitGoogleLogging() is written to STDERR
I0113 11:52:30.171521  4916 main.cpp:263] Build: 2017-01-11 10:10:34 by intern
I0113 11:52:30.171634  4916 main.cpp:264] Version: 1.1.0
I0113 11:52:30.173796  4916 main.cpp:370] Using 'HierarchicalDRF' allocator
I0113 11:52:30.323016  4916 replica.cpp:776] Replica recovered with log positions 29 -> 30 with 0 holes and 0 unlearned
I0113 11:52:30.324899  4931 recover.cpp:451] Starting replica recovery
I0113 11:52:30.325320  4931 recover.cpp:477] Replica is in VOTING status
I0113 11:52:30.327865  4933 master.cpp:380] Master 4b20f3a0-61d7-4797-b5a4-72555b1cd11b (SBSCLR03.SUNTECSBS.COM) started on 192.168.61.1:5050
I0113 11:52:30.327885  4933 master.cpp:382] Flags at startup: --agent_ping_timeout="15secs" --agent_reregister_timeout="10mins" --allocation_interval="1secs" --allocator="HierarchicalDRF" --authenticate_agents="false" --authenticate_frameworks="false" --authenticate_http_frameworks="false" --authenticate_http_readonly="false" --authenticate_http_readwrite="false" --authenticators="crammd5" --authorizers="local" --framework_sorter="drf" --help="false" --hostname_lookup="true" --http_authenticators="basic" --initialize_driver_logging="true" --ip="192.168.61.1" --log_auto_initialize="true" --logbufsecs="0" --logging_level="INFO" --max_agent_ping_timeouts="5" --max_completed_frameworks="50" --max_completed_tasks_per_framework="1000" --port="5050" --quiet="false" --recovery_agent_removal_limit="100%" --registry="replicated_log" --registry_fetch_timeout="1mins" --registry_gc_interval="15mins" --registry_max_agent_age="2weeks" --registry_max_agent_count="102400" --registry_store_timeout="20secs" --registry_strict="false" --root_submissions="true" --user_sorter="drf" --version="false" --webui_dir="/home/intern/mesos-1.1.0/build/../src/webui" --work_dir="/home/intern/mesos" --zk_session_timeout="10secs"

I0113 11:52:30.328171  4933 master.cpp:434] Master allowing unauthenticated frameworks to register
I0113 11:52:30.328181  4933 master.cpp:448] Master allowing unauthenticated agents to register
I0113 11:52:30.328187  4933 master.cpp:462] Master allowing HTTP frameworks to register without authentication
I0113 11:52:30.328212  4933 master.cpp:504] Using default 'crammd5' authenticator
W0113 11:52:30.328232  4933 authenticator.cpp:512] No credentials provided, authentication requests will be refused
I0113 11:52:30.328238  4933 authenticator.cpp:519] Initializing server SASL
I0113 11:52:30.339933  4932 master.cpp:2017] Elected as the leading master!
I0113 11:52:30.339982  4932 master.cpp:1560] Recovering from registrar
I0113 11:52:30.340802  4935 log.cpp:553] Attempting to start the writer
I0113 11:52:30.342550  4931 replica.cpp:493] Replica received implicit promise request from __req_res__(1)@192.168.61.1:5050 with proposal 13
I0113 11:52:30.365202  4931 replica.cpp:342] Persisted promised to 13
I0113 11:52:30.365875  4937 coordinator.cpp:238] Coordinator attempting to fill missing positions
I0113 11:52:30.366163  4936 log.cpp:569] Writer started with ending position 30
I0113 11:52:30.369163  4935 registrar.cpp:362] Successfully fetched the registry (213B) in 28.975872ms
I0113 11:52:30.369359  4935 registrar.cpp:461] Applied 1 operations in 37851ns; attempting to update the registry
I0113 11:52:30.371188  4932 coordinator.cpp:348] Coordinator attempting to write APPEND action at position 31
I0113 11:52:30.371909  4932 replica.cpp:537] Replica received write request for position 31 from __req_res__(2)@192.168.61.1:5050
I0113 11:52:30.386276  4937 replica.cpp:691] Replica received learned notice for position 31 from @0.0.0.0:0
I0113 11:52:30.400754  4932 registrar.cpp:506] Successfully updated the registry in 31.31392ms
I0113 11:52:30.400919  4932 registrar.cpp:392] Successfully recovered registrar
I0113 11:52:30.401057  4934 coordinator.cpp:348] Coordinator attempting to write TRUNCATE action at position 32
I0113 11:52:30.401428  4933 master.cpp:1676] Recovered 0 agents from the registry (213B); allowing 10mins for agents to re-register
I0113 11:52:30.401530  4931 replica.cpp:537] Replica received write request for position 32 from __req_res__(3)@192.168.61.1:5050
I0113 11:52:30.420632  4932 replica.cpp:691] Replica received learned notice for position 32 from @0.0.0.0:0
I0113 11:52:34.868803  4937 http.cpp:391] HTTP GET for /master/state from 192.168.16.112:53882 with User-Agent='Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/55.0.2883.87 Safari/537.36'
I0113 11:52:44.934979  4936 http.cpp:391] HTTP GET for /master/state from 192.168.10.35:27466 with User-Agent='Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/55.0.2883.87 Safari/537.36'
I0113 11:52:54.968333  4934 http.cpp:391] HTTP GET for /master/state from 192.168.10.35:27467 with User-Agent='Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/55.0.2883.87 Safari/537.36'
I0113 11:53:04.987321  4930 http.cpp:391] HTTP GET for /master/state from 192.168.10.35:27467 with User-Agent='Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/55.0.2883.87 Safari/537.36'
I0113 11:53:15.023368  4930 http.cpp:391] HTTP GET for /master/state from 192.168.10.35:27467 with User-Agent='Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/55.0.2883.87 Safari/537.36'
I0113 11:53:25.160392  4931 http.cpp:391] HTTP GET for /master/state from 192.168.10.35:27467 with User-Agent='Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/55.0.2883.87 Safari/537.36'

`
Mesos-masster and agent is working fine. but each time I close the session in putty, the master is down. I am using Oracle Linux Server 6.7 The status of Mesos can be seen in http://master:5050, in Google Chrome, Internet Explorer. but not in Mozilla Firefox, It is showing

No master is currently leading ...

Add doc on Autoscaling solutions with Mesos

PermissionError:[Errno 13] Permission denied: '/genconf/config.yaml'

Hi,
I got a Mesosphere-EE, and when installed, I got a problelm:
Environment: Fedora 23 server (kernel 4.4), get UI though vnc.
Install cmd:
$bash dcos_generate_config.ee.sh --web –v

Running mesosphere/dcos-genconf docker with BUILD_DIR set to /home/mesos-ee/genconf
Usage of loopback devices is strongly discouraged for production use. Either use `--storage-opt dm.thinpooldev` or use `--storage-opt dm.no_warn_on_loop_devices=true` to suppress this warning.
07:53:46:: Logger set to DEBUG
07:53:46:: ====> Starting DCOS installer in web mode
07:53:46:: DCOS Installer v1
07:53:46:: Starting server ('0.0.0.0', 9000)

Then I start firefox though vnc, the vnc is on root. then:

07:53:57:: Root page requested.
07:53:57:: Serving /usr/local/lib/python3.4/site-packages/dcos_installer/templates/index.html
07:53:58:: Request for configuration type made.
07:53:58:: Configuration file not found, /genconf/config.yaml. Writing new one with all defaults.
07:53:58:: Error handling request
Traceback (most recent call last):
  File "/usr/local/lib/python3.4/site-packages/aiohttp/server.py", line 266, in start
    yield from self.handle_request(message, payload)
  File "/usr/local/lib/python3.4/site-packages/aiohttp/web.py", line 87, in handle_request
    resp = yield from handler(request)
  File "/usr/local/lib/python3.4/asyncio/coroutines.py", line 206, in coro
    res = func(*args, **kw)
  File "/usr/local/lib/python3.4/site-packages/dcos_installer/async_server.py", line 100, in configure_type
    return web.json_response(backend.determine_config_type())
  File "/usr/local/lib/python3.4/site-packages/dcos_installer/backend.py", line 141, in determine_config_type
    config = get_config(config_path=config_path)
  File "/usr/local/lib/python3.4/site-packages/dcos_installer/backend.py", line 114, in get_config
    return DCOSConfig(config_path=config_path)
  File "/usr/local/lib/python3.4/site-packages/dcos_installer/config/__init__.py", line 66, in __init__
    self.build()
  File "/usr/local/lib/python3.4/site-packages/dcos_installer/config/__init__.py", line 93, in build
    user_config = self.get_config()
  File "/usr/local/lib/python3.4/site-packages/dcos_installer/config/__init__.py", line 145, in get_config
    self.write()
  File "/usr/local/lib/python3.4/site-packages/dcos_installer/config/__init__.py", line 155, in write
    data = open(self.config_path, 'w')
PermissionError: [Errno 13] Permission denied: '/genconf/config.yaml'

But I already have a genconf/config.yaml, it look like:

bootstrap_url: http://<bootstrap_public_ip>:<your_port>
cluster_name: '<cluster-name>'
exhibitor_storage_backend: zookeeper
exhibitor_zk_hosts: <host1>:2181,<host2>:2181,<host3>:2181
exhibitor_zk_path: /dcos
master_discovery: static
master_list:
- <master-private-ip-1>
- <master-private-ip-2>
- <master-private-ip-3>
superuser_username: <username>
superuser_password_hash: <hashed-password>
resolvers:
- 8.8.8.8
- 8.8.4.4

I do not know what’s going on. If you have any idear, please let me know, thank you very much!

Exercise 3 - mesos ps error

Hi,

I've followed the exercises until the last step of the exercise 3 where I get this error when running mesos ps:

[vagrant@node1 ~]$ mesos ps --master=$MASTER
Traceback (most recent call last):
File "/usr/bin/mesos-ps", line 10, in
from mesos import http
ImportError: cannot import name http

I'm trying to figure out how to install the missing python lib, but wanted to report the issue as it seems to be something break in the centos image.

Improvements for Exercise 1

• Sounds weird: “We use CentOS 7 for this course and it is recommended for this course”
• Video says to create "mesos-node1" directory, but Quick reference has "mkdir vm-install"
• Video says to install "chef/centos-7.0", but Quick Reference has "chef/centos-7.1"
  • "chef" organization on atlas no longer exists, replaced by "bento"
  • "bento/centos-7.0" doesn't exist at all, should be replaced by "bento/centos-7.1"
  • Also, should be centos-7.1 all around because that is the supported version for Mesos
• Video doesn't say to add line "config.vm.hostname = "node1"" in Vagrant file

dead link "dcos.io"

The link pointing to https://github.com/mesosphere/open-docs/blob/master/dcos.io is dead - link's ancro text is "dcos.io", it is in the text:
THIS CONTENT IS DEPRECATED. FOR THE LATEST INFORMATION, SEE dcos.io.

Azure documentation gone?

Was formerly here: https://docs.mesosphere.com/install/azurecluster/ but now that's a redirect back to the /product page.

That old document at the link above described the use of the Azure Resource Manager template that still lives here: https://downloads.mesosphere.com/dcos/EarlyAccess/azuredeploy.json

Assumption is that Azure content should go in https://github.com/mesosphere/open-docs/tree/master/getting-started/cloud

Exercise 3 - Task not appearing in UI

Hi,

I'm running the latest version of Vagrant and have installed everything written in the documents (not necessarily installing what the instructor does in their videos), ,I'm also on Windows, but using git bash for ssh.

In exercise 3 I run the mesos-execute command and then look to the browser UI, but no task is ever displayed. I also have the issue where the browser continuously loses connection:

and after running the command my command line appears as so:

Replace Mesos CLI in tutorials with DCOS CLI

The Mesos CLI has been superceded by the DCOS CLI. Both are at feature parity, so we should rewrite the tutorials that use the Mesos CLI with the DCOS CLI.

Write some sensible ports documentation

Related to: mesosphere/marathon#2236

Improvements for Exercise 2

Quick Reference doesn't talk about how stopping the service might fail because vagrant sucks sometimes and how to compensate for it (the video does describe this).

Videos broken on advanced course

The videos at https://open.mesosphere.com/advanced-course/ are throwing the error

NoSuchKeyThe specified key does not exist.Videos/Mesos-Intro-Lecture-12/media/index_player.html8308D70ACEF492DCnpLqRUQScOm2NWLD16Q/wQXvVEjM3uPKRWU+epvZkEGe6n8ezqsCgqfy0ETUKr6+IjUZ0IXjiw0=

As an example, the URL https://s3-us-west-2.amazonaws.com/docs-staging.mesosphere.com/Videos/Mesos-Intro-Lecture-12/media/index_player.html?embedIFrameId=embeddedSmartPlayerInstance is throwing a 404 from AWS.

This was working until about 10AM ET today.

setup mesos cluster, but fail running

I only have three vm(ubuntu 12, centos 6.5, centos 7.2), all are low spec.

$ cat /etc/hosts
10.142.55.190 zk1
10.142.55.196 zk2
10.142.55.202 zk3

One master

At first, I set only one zookeeper ,mesos-master and marathon, I found I can not access marathon on http://10.142.55.190:8080/ . And mesos-master only find mesos-slave on same machine. Other two mesos-slave seems not connect to master. And marathon quit immediately after service marathon start.

config in each mathine:

$ cat /etc/mesos/zk
zk://zk1:2181/mesos

I look the log in /etc/mesos, but nothing helpful. So I try to setup a cluster like the docs.

Three master

I setup zookeeper , mesos-master and mesos-slave on each three vm.(only centos 6.5 not install marathon , because of mesosphere/marathon#4409, other two vm installed marathon several days ago, so not affacted)

config in each mathine:

$ cat /etc/mesos/zk
zk://zk1:2181,zk2:2181,zk3:2181/mesos

This time, mesos page get error:

Failed to connect to 10.142.55.190:5050!
Retrying in 16 seconds... 

log on page is :

I0919 09:56:54.247023  3856 replica.cpp:493] Replica received implicit promise request from (22960)@127.0.1.1:5050 with proposal 153715
I0919 09:56:54.247632  3856 leveldb.cpp:304] Persisting metadata (10 bytes) to leveldb took 575808ns
I0919 09:56:54.247664  3856 replica.cpp:342] Persisted promised to 153715
I0919 09:56:54.247697  3856 replica.cpp:493] Replica received implicit promise request from (22959)@127.0.1.1:5050 with proposal 153715
I0919 09:56:54.247719  3856 replica.cpp:498] Replica denying promise request with proposal 153715
I0919 09:56:54.247812  3856 log.cpp:565] Could not start the writer, but can be retried
I0919 09:56:54.247917  3856 log.cpp:553] Attempting to start the writer
I0919 09:56:54.248098  3856 replica.cpp:493] Replica received implicit promise request from (22962)@127.0.1.1:5050 with proposal 153716
I0919 09:56:54.249294  3856 leveldb.cpp:304] Persisting metadata (10 bytes) to leveldb took 1.163608ms
I0919 09:56:54.249394  3856 replica.cpp:342] Persisted promised to 153716
I0919 09:56:54.249480  3856 replica.cpp:493] Replica received implicit promise request from (22961)@127.0.1.1:5050 with proposal 153716
I0919 09:56:54.249606  3856 replica.cpp:498] Replica denying promise request with proposal 153716
I0919 09:56:54.249773  3856 log.cpp:565] Could not start the writer, but can be retried
I0919 09:56:54.249936  3856 log.cpp:553] Attempting to start the writer
I0919 09:56:54.250360  3856 replica.cpp:493] Replica received implicit promise request from (22963)@127.0.1.1:5050 with proposal 153717
I0919 09:56:54.263665  3856 leveldb.cpp:304] Persisting metadata (10 bytes) to leveldb took 13.194807ms
I0919 09:56:54.263883  3856 replica.cpp:342] Persisted promised to 153717
I0919 09:56:54.264013  3856 replica.cpp:493] Replica received implicit promise request from (22964)@127.0.1.1:5050 with proposal 153717

at /var/log/mesos ,
fatal:

Log file created at: 2016/09/19 10:36:16
Running on machine: ubuntu12
Log line format: [IWEF]mmdd hh:mm:ss.uuuuuu threadid file:line] msg
F0919 10:36:16.499060  4786 master.cpp:1536] Recovery failed: Failed to recover registrar: Failed to perform fetch within 1mins

warn:

Log file created at: 2016/09/19 10:46:38
Running on machine: ubuntu12
Log line format: [IWEF]mmdd hh:mm:ss.uuuuuu threadid file:line] msg
W0919 10:46:38.052080  5681 authenticator.cpp:512] No credentials provided, authentication requests will be refused

can not access marathon too.

Add doc on running Dockerized Mesos master/slave

Linking to the DCOS Support page is confusing

• open support shouldn't use intercom
• feedback should be through issues or PRs on this repo
• directing to the "DCOS Knowledge Base" is confusing. If the KB has non-DCOS help in it, then maybe it should have DCOS in the title, or at least the link, or describe why we're sending you to DCOS KB for non-DCOS support.

Please add a LICENSE file to this repository

Thankyou!

Update terminology from master/slave

As per MESOS-1478, we're moving to master/agent. The docs on this site should be updated to reflect that.

ImportError: No module named mesos

When I get to last step of Exercise 3 and try to bring up the mesos ps I get a python import error.

[vagrant@node1 mesos]$ mesos ps --master=$MASTER
Traceback (most recent call last):
  File "/usr/bin/mesos-ps", line 10, in <module>
    from mesos import http
ImportError: No module named mesos

I have my path setup as follows:

# ~/.bash_profile
export PYTHONPATH=${PYTHONPATH}:/usr/lib/python2.7/site-packages/

Any ideas? It appears python is unaware of where to find the packages. Maybe I overlooked something?

Add a brief tutorial on how to configure Mesos + Marathon to deploy services with rack awareness

Related to: https://mesosphere.github.io/marathon/docs/constraints.html

Digitalocean links don't lead to Digitalocean content

Ref: https://github.com/mesosphere/open-docs/blob/master/getting-started/cloud/digitalocean/mesosphere.md

References inside to digitalocean.mesosphere.com, but that redirects to the generic Community vs Enterprise page.

Docs reference the Launchpad but there is no Digitalocean content on the launchpad.

Create doc on setting priorities for running multiple frameworks on Mesos

Exercise 7 doesn't work as described on all platforms

The newest mesos-dns requires go1.5, but many systems (including our supported ubuntu 14.04) don't come preinstalled with the latest version of Go. As such, the current instructions don't work as described in exercise 7. My workaround for this was to install the binary version of mesos-dns from: https://github.com/mesosphere/mesos-dns/releases

Also, the UI in the video is now different than the UI in the newest version of Marathon, so the location of the "Constraints" field is different. Even with that, I couldn't get the constraints as described to work properly :(

Trouble building mesos-dns

Hi,

I am working my way through the tutorial and get stuck a bit at the point where I have to build mesos-dns Building and running mesos-dns. For me it seems like the given command does not work:

make restoredeps build

The current build instructions for mesos-dns show a different way how to build mesos-dns.

godep go build ./...

This worked also not for me.
For me the following command worked:

godep go build 

What is the correct way to build mesos-dns for the tutorial?

Many Thanks for the great tutorial so far!
Matthias

Tidy up reference pages on Mesos master and Mesos slave

The grammar and formatting are inconsistent and there are typos.

Add doc on Mesos + Go support

List popular Go projects, bindings and tools.