cookbook 'mesos', '= 3.3.0'
mesos (16) Versions 3.3.0 Follow22
Installs/Configures Apache Mesos
cookbook 'mesos', '= 3.3.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.
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.22.1
- 0.22.0
- 0.21.1
- 0.21.0
- 0.20.1
- 0.20.0
We intend to support at most the three latest versions of Apache Mesos including
all patch releases for supported major versions. Ex. 0.21.0 + 0.21.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’s also configured 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.
repo
The repo recipe contains logic for setting up Mesosphere debian and RPM
repositories.
Dependencies
The following cookbooks are dependencies:
The following cookbooks are suggested:
- exhibitor (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 master: flags: cluster: 'mesos-sandbox' zk: 'zk://127.0.0.1:2181/mesos' 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
slave:
flags:
master: 'zk://127.0.0.1:2181/mesos'
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.
Unreleased
[3.3.0] - 2015-07-05
Added
- Added support for Apache Mesos 0.22.1.
- Added vagrant-wrapper in gemfile for testing.
- Set ulimit for init service if defined.
- Install mesosphere packages from a package mirror.
Changed
- Switched to using port 80 for Ubuntu Keyservers to get through corporate firewalls.
3.2.3 - 2015-03-29
Fixed
- Fixed master and slave recipes to use node override for zk endpoints.
3.2.2 - 2015-03-29
Fixed
- Fixed master and slave recipes to use node instead of default to set zk endpoints.
3.2.1 - 2015-03-29
Fixed
- Fixed zk exhibitor discovery logic to use new master and slave flags.
3.2.0 - 2015-03-29
Changed
- Updated default Mesos version to 0.21.1.
- Added support for Mesos 0.22.0.
- Removed support for Mesos 0.19.x.
3.1.0 - 2015-03-27
Changed
- Refactor greatly simplifies Mesos wrapper script.
- Configuration now passed primarily via command line flags.
- Switched to Upstart & Sysvinit for Mesos init.
- Metadata uses suggests instead of recommends for the exhibitor cookbook.
Contributors for this release:
- Robert Vežnaver - Amazing Mesos wrapper refactor.
Thank You!
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.3.0 failed this metric
FC031: Cookbook without metadata file: /tmp/cook/262edf3cc84bf1b98c165749/mesos/metadata.rb:1
FC045: Consider setting cookbook name in metadata: /tmp/cook/262edf3cc84bf1b98c165749/mesos/metadata.rb:1
3.3.0 failed this metric
FC045: Consider setting cookbook name in metadata: /tmp/cook/262edf3cc84bf1b98c165749/mesos/metadata.rb:1