To deploy Mesos in Rancher, you’ll first need to create a new environment that has an environment template with the container orchestration set as Mesos.

Creating a Mesos Environment

In the dropdown of environments, click on the Manage Environments. To create a new environment, click on Add Environment, provide a Name, Description (Optional), and select an environment template that has Mesos as the orchestration. If access control is turned on, you can add members and select their membership role. Anyone added to the membership list would have access to your environment.

After a Mesos environment has been created, you can navigate to the environment by either selecting the name of the environment in the environment’s dropdown in the upper left hand corner or by selecting Switch to this Environment in the specific environment’s drop down.

Note: As Rancher adds support for multiple container orchestration frameworks, Rancher currently does not support the ability to switch between environments that already have services running in it.

Starting Mesos

After a Mesos environment has been created, the infrastructure services will not be started until you add at least one host to your environment. The Mesos service will require ate least 3 hosts to be added. The process of adding hosts is the same steps for all container orchestration types. Once the first host has been added, Rancher will automatically start the deployment of the infrastructure services including the Mesos services (i.e. mesos-master, mesos-slave and zookeeper). You can see the progress of the deployment by accessing the Mesos tab.

Note: Only admins of Rancher or owners of the environment will be able to view the infrastructure services.

Using Mesos

Once the setup has completed, you can begin to create or manage your own Mesos applications via the following ways:

Mesos UI

You can manage Mesos by clicking on the Mesos UI. A new webpage will open up with a different UI to manage Mesos. Any frameworks created in this UI will also be reflected in Rancher.

Rancher Catalog

Rancher supports the capability of hosting a catalog of Mesos frameworks. To use a framework, click on either the Mesos -> Launch a framework button or click on the Catalog tab. Select the framework that you want to launch and click View Details. Review and edit the stack name, stack description, and configuration options and click on Launch.

If you want to add your own templates to Mesos, you add them to your own private Rancher catalog and place your templates in a mesos-templates folder.