Skip to content

chef-partners/dcos-cookbook

Repository files navigation

Build Status

Description

Manage deployment and configuration of underlying Mesosphere DC/OS installation. This cookbook supports both DC/OS OSS installations (default) and DC/OS Enterprise.

Note: The default username and password for DC/OS Enterprise is bootstrapuser/deleteme and can be changed by setting node['dcos']['config']['superuser_username'] and node['dcos']['config']['superuser_password_hash'], respectively.

Requirements

Only Red Hat or CentOS 7.x are currently supported.

Usage

The behavior of this cookbook is managed by attributes documented in the attributes file. The node['dcos']['dcos_role'] attribute controls the DC/OS role to apply to the node (default is master). The node['dcos']['config']['master_list'] must be set when node['dcos']['config']['master_discovery'] is set to static to specify the list of DC/OS master node IPv4 addresses to connect at startup (this must be an odd number of masters and cannot be changed, later).

This cookbook uses the stable channel, by default. Setting node['dcos']['dcos_version'] to earlyaccess will install the latest EarlyAccess version of DC/OS OSS. Enterprise support can be enabled by setting node['dcos']['dcos_enterprise'] to true and providing a license key in node['dcos']['dcos_license_text'] via whichever manner you prefer.

Roles

You can create a Chef Role and apply it to nodes as necessary to specify master, slave and slave_public, as appropriate. Any additional configuration should be set as override attributes in an Environment to ensure that all nodes receive those global settings.

Example Role dcos_master.rb

name "dcos_master"
description "DC/OS master role"
run_list "recipe[dcos]"
default_attributes "dcos" => {
    "dcos_role" => "master",
    "config" => {
        "master_list" => [ "10.0.2.10" ]
    }
}

Example Role dcos_slave.rb

name "dcos_slave"
description "DC/OS slave role"
run_list "recipe[dcos]"
default_attributes "dcos" => {
    "dcos_role" => "slave",
    "config" => {
        "master_list" => [ "10.0.2.10" ]
    }
}

Recipe

default

Installs the prerequisites for the Mesosphere DC/OS installation, including packages, and groups. Docker with OverlayFS is installed and enabled if node['dcos']['manage_docker'] is set to true, which is the default. Next, the recipe downloads and runs the installation package with the settings configured by the attributes under node['dcos']['config'].

Resource

dcos_user

Defines a DC/OS user.

Example dcos_user

dcos_user 'user@domain.com' do
  email 'user@domain.com'
end

It's possible Zookeeper is not up and running at the time you attempt to provision a DC/OS user. If that is the case, you should add an ignore_failure set to true in the used declaration:

Example dcos_user with ignore_failure

dcos_user 'user@domain.com' do
  ignore_failure true
  email 'user@domain.com'
end

Testing

ChefSpec

There is basic coverage for the default recipe.

InSpec

There is basic functional testing of the DC/OS OSS setup for a single master node.

Test Kitchen

The included .kitchen.yml runs the default master deployment in a generic fashion. The included .kitchen.local.yml.example shows alternate settings for running multi-master with slaves on GCE (you will have to rename and update accordingly).

License and Author

Author:: Matt Ray (matt@chef.io)

Copyright 2016-2018 Chef Software, Inc.

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.