dcos-grid Cookbook

This cookbook sets up your customized DC/OS cluster on bare metal, virtual machines and every cloud. This install method is based on Advanced DC/OS Installation Guide.

Contents

• Requirements
  • platforms
  • packages
• Attributes
• Usage
  • Recipes
  • dcos-grid::default
  • dcos-grid::agent
  • dcos-grid::bootstrap
  • dcos-grid::cli (ver. 0.3.0 or later)
  • dcos-grid::cloud-config (for CoreOS only)
  • dcos-grid::master
  • dcos-grid::node
  • dcos-grid::node-commons
  • dcos-grid::public-agent
  • Role Examples
  • Uninstall DC/OS
• License and Authors

Requirements

platforms

• CentOS, Red Hat Enterprise Linux >= 7.2
• CoreOS Latest version.
• Ubuntu 16.04 (Experimental). DC/OS does not officially support Ubuntu yet. See Ubuntu 16.04 Enablement.
  • DC/OS requires systemd, which is only fully supported in Ubuntu 15.04 and later releases. See SystemdForUpstartUsers

packages

• none.

Attributes

Usage

Recipes

dcos-grid::default

This recipe does nothing.

dcos-grid::agent

This recipe sets up a private agent node. Note: If node['dcos-grid']['node']['auto_setup'] is false, you must execute the following manually.

$ /opt/dcos-grid/node_setup.sh slave

dcos-grid::bootstrap

This recipe sets up a bootstrap node. Note: Please execute the following manually.

$ /opt/dcos-grid/bootstrap_setup.sh

dcos-grid::cli (ver. 0.3.0 or later)

This recipe installs DC/OS CLI.

dcos-grid::cloud-config (for CoreOS only)

This recipe generates a /opt/dcos-grid/cloud-config.yaml template file on local machine by the following chef-solo command.

$ sudo chef-solo -c solo.rb -j nodes/local-dcos0-cloud-config.json

• nodes/local-dcos0-cloud-config.json

{
  "run_list": [
    "role[dcos0-cloud-config]"
  ]
}

• roles/dcos0-cloud-config.rb

name 'dcos0-cloud-config'
description 'dcos0 cloud-config.yaml file.'

run_list(
  'role[dcos0]',  # includes common attributes.
  'recipe[dcos-grid::cloud-config]',
)

Then edit this yaml template (hostname, ssh_authorized_keys, IP address and so on) and install CoreOS by the cloud-config.yaml.

$ coreos-cloudinit -from-file ~/cloud-config.yaml -validate
...
$ sudo coreos-install -d /dev/sda -C stable -c ~/cloud-config.yaml

dcos-grid::master

This recipe sets up a master node. Note: If node['dcos-grid']['node']['auto_setup'] is false, you must execute the following manually.

$ /opt/dcos-grid/node_setup.sh master

dcos-grid::node

This recipe sets up a base node (particular role is not assigned yet). Note: Please execute the following manually.

$ /opt/dcos-grid/node_setup.sh {master|slave|slave_public}

dcos-grid::node-commons

This recipe sets up common environment for DC/OS node.

dcos-grid::public-agent

This recipe sets up a public node. Note: If node['dcos-grid']['node']['auto_setup'] is false, you must execute the following manually.

$ /opt/dcos-grid/node_setup.sh slave_public

Role Examples

• roles/dcos0.rb: Common attributes.

name 'dcos0'
description 'dcos0 cluster'

run_list(
)

override_attributes(
  'dcos-grid' => {
    'dcos_release_url' => 'https://downloads.dcos.io/dcos/EarlyAccess/dcos_generate_config.sh',
    'docker-engine' => {
      'version_on_centos' => '1.11.2-1',
      'version_on_ubuntu' => '1.11.2-0',
      #'version' => '1.11.2-1.el7.centos',
    },
    'bootstrap' => {
      'ip' => '192.168.56.100',
      'port' => '8080',
      'config' => {
        'cluster_name' => 'dcos0',
        'master_list' => [
          '192.168.56.101',
          '192.168.56.102',
          '192.168.56.103',
        ],
        'resolvers' => [
          '8.8.8.8',
          '8.8.4.4',
        ],
      },
      'ip-detect' => {
        'interface' => 'eth1,enp0s8',
      },
    },
    'node' => {
      'auto_setup' => false,
    },
  },
)

• roles/dcos0-boot.rb

name 'dcos0-boot'
description 'dcos0 cluster bootstrap node'

run_list(
  'role[dcos0]',
  'recipe[dcos-grid::bootstrap]',
)

• roles/dcos-master.rb

name 'dcos0-master'
description 'dcos0 cluster master node'

run_list(
  'role[dcos0]',
  'recipe[dcos-grid::master]',
)

override_attributes(
  'dcos-grid' => {
    'node' => {
      'auto_setup' => false,
    },
  },
)

• roles/dcos0-agent.rb

name 'dcos0-agent'
description 'dcos0 cluster private agent node'

run_list(
  'role[dcos0]',
  'recipe[dcos-grid::agent]',
)

override_attributes(
  'dcos-grid' => {
    'node' => {
      'auto_setup' => true,
    },
  },
)

Uninstall DC/OS

Please log in each node and execute the following.

$ /opt/dcos-grid/uninstall.sh

License and Authors

• Author:: whitestar at osdn.jp

Copyright 2016, whitestar

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.