cookbook 'mesos', '= 3.0.0'
mesos (16) Versions 3.0.0 Follow22
Installs/Configures Apache Mesos
cookbook 'mesos', '= 3.0.0', :supermarket
knife supermarket install mesos
knife supermarket download mesos
Mesos Cookbook
Application cookbook for installing the Apache Mesos cluster manager.
Mesos provides efficient resource isolation and sharing across distributed
applications, or frameworks. This cookbook installs Mesos via packages
provided by Mesosphere.
This cookbook serves as the base for the following additional Mesos framework
cookbooks maintained by Medidata Solutions:
- marathon - This cookbook installs the Apache Mesos Marathon framework.
- chronos - This cookbook installs the Apache Mesos Chronos framework.
Requirements
- Chef >= 11
- Ruby 1.9.3 or higher
Platform
Tested on
- Ubuntu 14.04
- Ubuntu 13.10
- Ubuntu 12.04
- Debian Wheezy
- CentOS 6
Supported Mesos Versions
This cookbook supports the following Apache Mesos versions:
- 0.21.1
- 0.21.0
- 0.20.1
- 0.20.0
- 0.19.1
We intend to support at most the three latest versions of Apache Mesos including
all patch releases for supported major versions. Ex. 0.20.0 + 0.20.1 etc..
Attributes
In order to keep the README managable and in sync with the attributes, this
cookbook documents attributes inline. The usage instructions and default
values for attributes can be found in the individual attribute files.
Configuring Mesos via attributes
This cookbook introduces a few points of validation to prevent passing Mesos
invalid configuration options. The file [attributes/mesos_options.rb](attributes/mesos_options.rb)
contains a hash of all valid Mesos configuration options for all Mesos versions
supported by this cookbook. This cookbook will fail to converge if you try to
use an invalid configuration option as a command line flag attribute under
[‘mesos’][‘master’][‘flags]
or [‘mesos’][‘slave’][‘flags]
hashes.
The valid list of Mesos options are available in the Mesos documentation for the
latest options here: http://mesos.apache.org/documentation/latest/configuration/
as well as in this Google Sheets document which keeps track of what configuration
options are available per Mesos version here:
https://docs.google.com/spreadsheets/d/1IER03xhtOSj9unW5AYIqn-tu-laAHlPSOYhM6xw4QHg/edit#gid=0
Recipes
default
The default mesos recipe will run mesos::install.
install
The install recipe installs the specified version of the mesosphere mesos
RPM or Debian package and installs it. It also configures to stop both
mesos-master and mesos-slave init files so that they don't automatically
start on server restart.
master
The master recipe runs mesos::install as well as creating several
mesos-master configuration files that are used at startup. This recipe also
uses the zookeeper attributes and/or exhibitor attributes to configure the
mesos-master using zookeeper. Lastly it sets the mesos-master init config to
'start' so that mesos-master is started on server restart.
slave
The slave recipe runs mesos::install as well as creating several
mesos-slave configuration files that are used at startup. This recipe also
uses the zookeeper attributes and/or exhibitor attributes to configure the
mesos-slave using zookeeper. Lastly it sets the mesos-slave init config to
'start' so that mesos-slave is started on server restart.
Dependencies
The following cookbooks are dependencies:
The following cookbooks are suggested:
- zookeeper (used for discovering ZooKeeper ensembles via Netflix Exhibitor)
Usage
Here is a sample role for configuring a Mesos master in a ZooKeeper backed
production mode.
chef_type: role default_attributes: description: env_run_lists: json_class: Chef::Role name: mesos_master override_attributes: mesos: version: 0.21.1 cluster_name: mesos-sandbox zookeeper_server_list: [ '203.0.113.2', '203.0.113.3', '203.0.113.4' ] zookeeper_port: 2181 zookeeper_path: 'mesos-sandbox' run_list: recipe[mesos::master]
Here is a sample role for creating a Mesos slave node with a seperate ZooKeeper
ensemble dynamically discovered via Netflix Exhibitor:
YAML
chef_type: role
default_attributes:
description:
env_run_lists:
json_class: Chef::Role
name: mesos_slave
override_attributes:
mesos:
version: 0.21.1
cluster_name: mesos-sandbox
zookeeper_path: 'mesos'
zookeeper_exhibitor_discovery: true
zookeeper_exhibitor_url: 'http://zk-exhibitor-endpoint.example.com:8080'
run_list:
recipe[mesos::slave]
Development
Please see the [Contributing](CONTRIBUTING.md) and [Issue Reporting](ISSUES.md) Guidelines.
License and Author
- Author: Ray Rodriguez(rayrod2030@gmail.com)
Copyright 2015 Medidata Solutions Worldwide
Licensed under the Apache License, Version 2.0 (the "License"); you may not use
this file except in compliance with the License. You may obtain a copy of the
License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the
specific language governing permissions and limitations under the License.
Change Log
All notable changes to this project will be documented in this file.
This project adheres to Semantic Versioning.
3.0.0 - 2015-03-11
Changed
- Mesos is now installed via the Mesosphere RPM and deb package repositories.
- Added validation for Mesos flags to ensure that Mesos starts with configured flags.
- Added support for Mesos 0.21.1.
- Added all Mesos attributes which can be configured.
- Added libsvn1 depedency for newer Mesos versions.
- Updated rubocop style file.
Fixed
- Fixed a bug with the ZK exhibitor discovery mechanism.
- Fixed redhat family name in install recipe.
Removed
- Removed experimental docker recipe.
- Removed EC2 hostname logic.
- Removed support for Mesos 0.19.0.
2.0.0 - 2014-11-14
Changed
- Writes all attributes under
node['mesos']['common]
/node['mesos']['master']
to respective config files - Adds support for Ubuntu 14.04 (Trusty Tahr)
- Adds support for Debian 7 (Wheezy)
1.0.6 - 2014-02-19
Changed
- Re-added default-jre-headless as required package due to breaking issues with mesos debian package when used with a non-openjdk java like Oracle.
- Added some serverspecs to verify working cookbook with oracle jdk 7.
1.0.5 - 2014-02-15
Changed
- Removed default-jre-headless as required package
- Added slave checkpointing defaults
- Added kitchen-ec2 configuration for CI
1.0.4 - 2014-02-07
Changed
- Add support for RHEL linux family
- Updated integration tests (serverspec)
1.0.3 - 2014-02-03
Changed
- Fix zk_string generating logic to strip triailing comma
- Add exhibitor discover zookeepers retry logic
1.0.2 - 2014-01-31
Changed
- Fix docker-mesos egg url
1.0.1 - 2014-01-13
Changed
- Update default mesos version to 0.15.0
- Use attribute for mesos python bindings egg
1.0.0 - 2013-12-12
Changed
- Public release of cookbook
- Added experimental docker-mesos recipe
- Updated mesos default version to 0.14.2
[0.1.0] - 2013-10-08
Changed
- Initial Cookbook release
Foodcritic Metric
3.0.0 failed this metric
FC031: Cookbook without metadata file: /tmp/cook/98243f03d762dbec22fedeb4/mesos/metadata.rb:1
FC045: Consider setting cookbook name in metadata: /tmp/cook/98243f03d762dbec22fedeb4/mesos/metadata.rb:1
3.0.0 failed this metric
FC045: Consider setting cookbook name in metadata: /tmp/cook/98243f03d762dbec22fedeb4/mesos/metadata.rb:1