Apache Cotton

Clone this repo:


  1. 4aa9bb0 Adding Cotton RETIRED.txt for project exit from the Apache Incubator by jfarrell · 1 year, 6 months ago master
  2. d09af46 Put scheduler callbacks that need to access scheduler state under lock guards. by Jiang Yan Xu · 1 year, 10 months ago
  3. 1d30d10 Update "Getting Involved" section in README.md by Jiang Yan Xu · 1 year, 10 months ago
  4. 26af17e Mysos -> Cotton in README.md. by Jiang Yan Xu · 1 year, 10 months ago
  5. efad307 Update mailing list in README.md. by Jiang Yan Xu · 1 year, 10 months ago

Apache Cotton

Apache Cotton (previously named Mysos) is an Apache Mesos framework for running MySQL instances. It dramatically simplifies the management of a MySQL cluster and is designed to offer:

  • Efficient hardware utilization through multi-tenancy (in performance-isolated containers)
  • High reliability through preserving the MySQL state during failure and automatic backing up to/restoring from HDFS
  • An automated self-service option for bringing up new MySQL clusters
  • High availability through automatic MySQL master failover
  • An elastic solution that allows users to easily scale up and down a MySQL cluster by changing the number of slave instances

Cotton has been accepted into the Apache Incubator.


A user guide is available. Documentation improvements are always welcome, so please send patches our way.

Getting Involved

Please check out the source code from Apache's git repostory:

git clone https://git-wip-us.apache.org/repos/asf/incubator-cotton.git

or if you prefer GitHub, use the GitHub mirror:

git clone https://github.com/apache/incubator-cotton.git

The Cotton community maintains the following project supporting services:


Licensed under the Apache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0


  • Python 2.7
  • Mesos Python bindings


Build status on Travis CI

Building/Downloading Mesos Python Bindings

Cotton uses Mesos Python bindings which consist of two Python packages. mesos.interface is on PyPI and gets automatically installed but mesos.native is platform dependent. You need to either build the package on your machine (instructions) or download a compiled one for your platform (e.g. Mesosphere hosts the eggs for some Linux platforms).

Since pip doesn't support eggs, you need to convert eggs into wheels using wheel convert, then drop them into the 3rdparty folder. See the README file for more information.

Building Cotton

Cotton mainly consists of two components that are built and deployed separately.

  • mysos_scheduler: The scheduler that connects to Mesos master and manages the MySQL clusters.
  • mysos_executor: The executor that is launched by Mesos slave (upon mysos_scheduler's request) to carry out MySQL tasks.

One way to package these components and their dependencies into a self-contained executable is to use PEX. This allow Cotton components to be launched quickly and reliably. See End-to-end test using PEX for an example of packaging and deploying the executor using PEX.


Unit Tests

Make sure tox is installed and just run:


The unit tests don't require the mesos.native package to be available in 3rdparty. Tox also builds the Cotton source package and drops it in .tox/dist.

End-to-end Test on a Local Mesos Cluster and PEX

Build/download the mesos.native package and put it in 3rdparty and then run:

tox -e pex

This test demonstrates how to package a PEX executor and use it to launch a fake MySQL cluster on a local Mesos cluster.

End-to-end Test on a Real Mesos Cluster in a Vagrant VM

The Vagrant test uses the sdist Cotton package in .tox/dist so be sure to run tox first. Then:

vagrant up

# Wait for the VM and Cotton API endpoint to come up ( becomes available).

tox -e vagrant

test.sh verifies that Cotton successfully creates a MySQL cluster and then deletes it.