Deploy and manage containers (including Docker) on top of Apache Mesos at scale.
Marathon is a production-proven Apache Mesos framework for container orchestration. DC/OS is the easiest way to start using Marathon. Issues are tracked in JIRA.
Marathon provides a REST API for starting, stopping, and scaling applications. Marathon is written in Scala and can run in highly-available mode by running multiple copies. The state of running tasks gets stored in the Mesos state abstraction.
Marathon is also used as a meta framework: you can start other Mesos frameworks such as Chronos or Storm with it to ensure they survive machine failures. It can launch anything that can be launched in a standard shell. In fact, you can even start other Marathon instances via Marathon.
/metricsin JSON format, push them to systems like Graphite, StatsD and DataDog, or scrape them using Prometheus.
Marathon documentation is available on the Marathon GitHub pages site.
Documentation for installing and configuring the full Mesosphere stack including Mesos and Marathon is available on the Mesosphere website.
Marathon uses JIRA to track issues. You can browse existing issues or file a new issue with your GitHub account.
Note for users of GitHub issues: All existing issues have been migrated and closed, and a reference to the related JIRA has been added as a comment. We leave the GitHub issues available for reference. Going forward please use JIRA always.
We heartily welcome external contributions to Marathon's documentation. Documentation should be committed to the
masterbranch and published to our GitHub pages site using the instructions in docs/README.md.
Marathon has the following compile-time dependencies: * sbt - A build tool for scala. You can find the instructions for installing sbt for Mac OS X and Linux over here. * JDK 1.8+
For run-time, Marathon has the following dependencies: * libmesos - JNI bindings for talking to Apache Mesos master. Look at the Install Mesos section for instructions to get libmesos. * Apache Zookeeper - You can have a separate Zookeeper installation specifically for Marathon, or you can use the same Zookeeper used by Mesos.
The by far easiest way to get Marathon running is to use DC/OS. Marathon is pre-bundled into DC/OS.
Marathon requires libmesos, a shared object library, that contains JNI bindings for Marathon to talk to the Mesos master. libmesos comes as part of the Apache Mesos installation. There are three options for installing Apache Mesos.
Instructions on how to install prepackaged releases of Mesos are available in the Marathon docs.
NOTE: Choose this option only if building Marathon from source, else there might be version incompatibility between pre-packaged releases of Marathon and Mesos built from source.
You can find the instructions for compiling Mesos from source in the Apache Mesos getting started docs. If you want Mesos to install libraries and executables in a non-default location use the --prefix option during configuration as follows:
./configure --prefix=
The
make installwill install libmesos (libmesos.so on Linux and libmesos.dylib on Mac OS X) in the install directory.
NOTE: Choose this option only if building Marathon from source, else there might be version incompatibility between pre-packaged releases of Marathon and Mesos built from source.
The Mesos Version Manager (mvm) compiles, configures, and manages multiple versions of Apache Mesos. It allows switching between versions quickly, making it easy to test Marathon against different versions of Mesos.
The Mesos Version Manager assumes that all dependencies of Apache Mesos are readily installed.
Please refer to the Apache Mesos getting started docs for instructions on how to set up the build environment.
MVM compiles Mesos with SSL support by default, which requires openssl and libevent to be installed.
On macOS, the packages can be installed using brew:
brew install openssl libevent
sudo yum install -y libevent-devel openssl-devel
The script can be run as follows:
cd marathon cd tools ./mvm.sh [SHELL]
The following command will launch a bash shell configured for Mesos 1.2.0:
./mvm.sh 1.2.0 bash
You should consider placing the script into a folder in your shell's
PATHif you are using it regularly.
The mvm script accepts three different formats as version name:
./mvm.sh --tagsin order to obtain a list of available tags.
--latestflag, which automatically chooses the latest development version:
./mvm.sh --latest.
MVM Will automatically download & compile Apache Mesos if necessary.
It will then spawn a new bash shell with the chosen version of Mesos activated.
For more information see
./mvm.sh --help.
Note: You will have to re-run the script if you wish to use Mesos after closing the shell. See
./mvm.sh --helpinformation on how to permanently configure your shell for mvm to avoid this.
Instructions on how to install prepackaged releases are available in the Marathon docs. Alternatively, you can build Marathon from source.
To build Marathon from source, check out this repo and use sbt to build a universal:
git clone https://github.com/mesosphere/marathon.git cd marathon sbt 'run --master localhost:5050 --zk zk://localhost:2181/marathon'
Troubleshooting
Failure in retrieval of IP address of the local machine will result in an error and may look like this:
Failed to obtain the IP address for ''; the DNS service may not be able to resolve it: nodename nor servname provided, or not known
Make sure that
LIBPROCESS_IPenvironment variable is set.
export LIBPROCESS_IP="127.0.0.1"
When the
MESOS_NATIVE_JAVA_LIBRARYenvironment variable is not set, the following error may occur,
java.lang.UnsatisfiedLinkError: no mesos in java.library.path...
Make sure that
MESOS_NATIVE_JAVA_LIBRARYenvironment variable is set.
export MESOS_NATIVE_JAVA_LIBRARY="/path/to/mesos/lib/libmesos.dylib"
Run
sbt universal:packageZipTarballto package Marathon as an txz file containing bin/marathon fully packaged.
Run
cd tools/packager; make tag-dockerfor a local Marathon docker image.
Mesos local mode allows you to run Marathon without launching a full Mesos cluster. It is meant for experimentation and not recommended for production use. Note that you still need to run ZooKeeper for storing state. The following command launches Marathon on Mesos in local mode. Point your web browser to
http://localhost:8080to see the Marathon UI.
mesos-local sbt 'run --master localhost:5050 --zk zk://localhost:2181/marathon'
For more information on how to run Marathon in production and configuration options, see the Marathon docs.
See developing Marathon in the docs.
Ruby gem and command line client
Running Chronos with the Ruby Marathon Client:
marathon -M http://foo.bar:8080 start -i chronos -u https://s3.amazonaws.com/mesosphere-binaries-public/chronos/chronos.tgz \ -C "./chronos/bin/demo ./chronos/config/nomail.yml \ ./chronos/target/chronos-1.0-SNAPSHOT.jar" -c 1.0 -m 1024
Ruby gem marathon_deploy alternative command line tool to deploy using json or yaml files with ENV macros.
Scala client, developed at Guidewire
Java client, developed at Mesosphere
Java client by Mohit Soni
Maven plugin, developed by Johannes Unterstein
Maven plugin, developed at HolidayCheck
Python client, developed at The Factory
Python client, developed at Wizcorp
Go client by Rohith Jayawardene
Go client by Jean-Baptiste Dalido
Node client by Silas Sewell
Clojure client by Halit Olali
sbt plugin, developed at Tapad
Across all installations Marathon is managing applications on more than 100,000 nodes world-wide. These are some of the companies using it:
Not in the list? Open a pull request and add yourself!
Have you found an issue? Feel free to report it using our JIRA Issues page. In order to speed up response times, we ask you to provide as much information on how to reproduce the problem as possible. If the issue is related in any way to the web UI, we kindly ask you to use the
guilabel.
If you have questions, please post on the Marathon Framework email list.
You can find Marathon support in the
#marathonchannel, and Mesos support in the
#mesoschannel, on freenode (IRC). Alternatively, check out the same channels on the Mesos Slack (request an invitation here).
The team at Mesosphere is also happy to answer any questions.
If you'd like to take part in design research and test new features in Marathon before they're released, please add your name to our UX Research list.
Marathon was created by Tobias Knaup and Florian Leibert and continues to be developed by the team at Mesosphere and by many contributors from the community.
YourKit, LLC
YourKit supports open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of YourKit Java Profiler and YourKit .NET Profiler, innovative and intelligent tools for profiling Java and .NET applications.