Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status

RSS

dcos-grid (23) Versions 0.4.8

Installs/Configures DC/OS Cluster Node.

Policyfile
Berkshelf
Knife
cookbook 'dcos-grid', '= 0.4.8', :supermarket
cookbook 'dcos-grid', '= 0.4.8'
knife supermarket install dcos-grid
knife supermarket download dcos-grid
README
Dependencies
Changelog
Quality 50%

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

  • 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.

cookbooks

  • docker-grid (for dcos-grid ver. 0.4.0 or later).

Attributes

Key Type Description, example Default
['dcos-grid']['dcos_release_url'] String DC/OS download URL. 'https://downloads.dcos.io/dcos/stable/dcos_generate_config.sh'
['dcos-grid']['dcos_release_script_name'] String OSS edition: 'dcos_generate_config.sh', Enterprise edition: 'dcos_generate_config.ee.sh' (ver. 0.4.8 or later). Pathname(URI(node['dcos-grid']['dcos_release_url']).path).basename
['dcos-grid']['dcos_cli_release_url'] String DC/OS CLI download URL (ver. 0.3.0 or later). 'https://downloads.dcos.io/binaries/cli/linux/x86-64/dcos-1.8/dcos'
['dcos-grid']['dcos_cli_upgrade'] Boolean Whether upgrade DC/OS CLI or not (ver. 0.4.3 or later). false
['dcos-grid']['docker']['apt_repo']['url'] String DEPRECATED: use ['docker-grid']['apt_repo']['url'] (ver. 0.4.0 or later) nil
['dcos-grid']['docker']['apt_repo']['keyserver'] String DEPRECATED: use ['docker-grid']['apt_repo']['keyserver'] (ver. 0.4.0 or later) nil
['dcos-grid']['docker']['apt_repo']['recv-keys'] String DEPRECATED: use ['docker-grid']['apt_repo']['recv-keys'] (ver. 0.4.0 or later) nil
['dcos-grid']['docker']['yum_repo']['baseurl'] String DEPRECATED: use ['docker-grid']['yum_repo']['baseurl'] (ver. 0.4.0 or later) nil
['dcos-grid']['docker']['yum_repo']['gpgcheck'] String DEPRECATED: use ['docker-grid']['yum_repo']['gpgcheck'] (ver. 0.4.0 or later). '0': disabled, '1': enabled. nil
['dcos-grid']['docker']['yum_repo']['gpgkey'] String DEPRECATED: use ['docker-grid']['yum_repo']['gpgkey'] (ver. 0.4.0 or later) nil
['dcos-grid']['docker-engine']['setup'] Boolean Docker setup by this cookbook. If you will set up Docker by another cookbook, verify that this attribute is false. (ver. 0.3.0 or later) true
['dcos-grid']['docker-engine']['version_on_centos'] String DEPRECATED: use ['docker-grid']['engine']['version_on_centos'] (ver. 0.4.0 or later). Docker version for CentOS. nil
['dcos-grid']['docker-engine']['version_on_ubuntu'] String DEPRECATED: use ['docker-grid']['engine']['version_on_ubuntu'] (ver. 0.4.0 or later). Docker version for Ubuntu. nil
['dcos-grid']['docker-engine']['version'] String DEPRECATED: use ['docker-grid']['engine']['version'] (ver. 0.4.0 or later). Docker 1.9.x - 1.11.x is recommended for stability reasons. Note: this default value is overwritten by the version_on_{centos or ubuntu}. See default.rb
['dcos-grid']['docker-engine']['storage-driver_on_centos'] String DEPRECATED: use ['docker-grid']['engine']['storage-driver_on_centos'] (ver. 0.4.0 or later). Docker storage driver (overlay, devicemapper, ...) for CentOS. nil
['dcos-grid']['docker-engine']['storage-driver_on_ubuntu'] String DEPRECATED: use ['docker-grid']['engine']['storage-driver_on_ubuntu'] (ver. 0.4.0 or later). Docker storage driver (aufs, overlay, ...) for Ubuntu. nil
['dcos-grid']['docker-engine']['storage-driver'] String DEPRECATED: use ['docker-grid']['engine']['storage-driver'] (ver. 0.4.0 or later). See default.rb
['dcos-grid']['docker-engine']['daemon_extra_options'] String DEPRECATED: use ['docker-grid']['engine']['daemon_extra_options'] (ver. 0.4.0 or later). ref. docker daemon --help. nil
['dcos-grid']['bootstrap']['ip'] String Bootstrap node IP address. '127.0.0.1'
['dcos-grid']['bootstrap']['port'] String Bootstrap node port number. '8080'
['dcos-grid']['bootstrap']['genconf_dir'] String genconf directory path. Note: This is overridden by the value "#{node['dcos-grid']['cloud-config']['target_dir']}/genconf" in the cloud-config recipe (ver. 0.3.5 or later). '/opt/dcos-grid/genconf'
['dcos-grid']['bootstrap']['config'] Hash Install configurations. see Install Configuration Parameters
['dcos-grid']['bootstrap']['config']['bootstrap_url'] String "http://#{node['dcos-grid']['bootstrap']['ip']}:#{node['dcos-grid']['bootstrap']['port']}"
['dcos-grid']['bootstrap']['config']['cluster_name'] String 'dcos0'
['dcos-grid']['bootstrap']['config']['exhibitor_storage_backend'] String 'static'
['dcos-grid']['bootstrap']['config']['ip_detect_filename'] String '/genconf/ip-detect'
['dcos-grid']['bootstrap']['config']['master_discovery'] String (ver. 0.3.2 or later) 'static'
['dcos-grid']['bootstrap']['config']['master_list'] Array e.g. ['192.168.1.101','192.168.1.102','192.168.1.103'] nil
['dcos-grid']['bootstrap']['config']['oauth_auth_host'] String (ver. 0.3.2 or later) 'https://dcos.auth0.com'
['dcos-grid']['bootstrap']['config']['oauth_auth_redirector'] String (ver. 0.3.2 or later) 'https://auth.dcos.io'
['dcos-grid']['bootstrap']['config']['oauth_available'] String (ver. 0.3.2 or later) 'true'
['dcos-grid']['bootstrap']['config']['oauth_enabled'] String (ver. 0.3.2 or later) 'true'
['dcos-grid']['bootstrap']['config']['oauth_issuer_url'] String (ver. 0.3.2 or later) 'https://dcos.auth0.com/'
['dcos-grid']['bootstrap']['config']['resolvers'] Array e.g. ['8.8.8.8','8.8.4.4'] (Google DNS) nil
['dcos-grid']['bootstrap']['config']['telemetry_enabled'] String 'false' (ver. 0.4.1 or later)
['dcos-grid']['bootstrap']['bootstrap']['ip-detect']['interface'] String Network interface on each node for the ip-detect script. Note: If you set comma-delimited interface list (e.g. 'eth0,enp0s3'), the first detected interface's ip is adopted (ver. 0.3.0 or later). 'eth0'
['dcos-grid']['node']['auto_setup'] Boolean execute the node setup script automatically or not. false
['dcos-grid']['cloud-config']['target_platform'] String CoreOS only now. 'coreos'
['dcos-grid']['cloud-config']['target_dir'] String '/home/core'
['dcos-grid']['cloud-config']['target_owner'] String 'core:core'
['dcos-grid']['cloud-config']['hostname'] String '<fqdn>'
['dcos-grid']['cloud-config']['ssh_authorized_keys'] Array ['<your_ssh_pub_key>',]

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 /home/core/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
cluster_name = 'dcos0'

name "#{cluster_name}-cloud-config"
description "#{cluster_name} cloud-config.yaml file."

run_list(
  "role[#{cluster_name}]",  # 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

dcos-grid::universe-build-env (ver. 0.4.8 or later)

This recipe sets up the build environment for DC/OS Universe (package repository) server.

Role Examples

  • roles/dcos0.rb: Common attributes.
cluster_name = 'dcos0'

name cluster_name
description "#{cluster_name} cluster"

run_list(
)

override_attributes(
  'docker-grid' => {
    'engine' => {
      'version_on_centos' => '1.11.2-1',
      'version_on_ubuntu' => '1.11.2-0',
      #'version' => '1.11.2-1.el7.centos',
    },
  },
  'dcos-grid' => {
    'dcos_release_url' => 'https://downloads.dcos.io/dcos/stable/dcos_generate_config.sh',
    #'dcos_release_url' => 'https://downloads.dcos.io/dcos/EarlyAccess/dcos_generate_config.sh',
    'dcos_cli_release_url' => 'https://downloads.dcos.io/binaries/cli/linux/x86-64/dcos-1.8/dcos',
    'bootstrap' => {
      'ip' => '192.168.56.100',
      'port' => '8080',
      'config' => {
        'cluster_name' => cluster_name,
        '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
cluster_name = 'dcos0'

name "#{cluster_name}-boot"
description "#{cluster_name} cluster bootstrap node"

run_list(
  "role[#{cluster_name}]",
  'recipe[dcos-grid::bootstrap]',
)
  • roles/dcos0-master.rb
cluster_name = 'dcos0'

name "#{cluster_name}-master"
description "#{cluster_name} cluster master node"

run_list(
  "role[#{cluster_name}]",
  'recipe[dcos-grid::master]',
)

override_attributes(
  'dcos-grid' => {
    'node' => {
      'auto_setup' => false,
    },
  },
)
  • roles/dcos0-agent.rb
cluster_name = 'dcos0'

name "#{cluster_name}-agent"
description "#{cluster_name} cluster private agent node"

run_list(
  "role[#{cluster_name}]",
  'recipe[dcos-grid::agent]',
)

override_attributes(
  'dcos-grid' => {
    'node' => {
      'auto_setup' => true,
    },
  },
)
  • roles/dcos0-cli.rb
cluster_name = 'dcos0'

name "#{cluster_name}-cli"
description "#{cluster_name} CLI setup"

run_list(
  "role[#{cluster_name}]",
  'recipe[dcos-grid::cli]',
)

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

Upgrade DC/OS (ver. 0.4.3 or later)

  • Update attributes about DC/OS release URL (['dcos-grid']['dcos_release_url']) and configurations (['dcos-grid']['bootstrap']['config']).

  • execute sudo chef-client on each node.

  • upgrade the boostrap node.

$ /opt/dcos-grid/bootstrap_upgrade.sh
  • upgrade each follower master node at first, and then upgrade the leader master node.
$ /opt/dcos-grid/node_upgrade.sh master
  • upgrade each agent node.
$ /opt/dcos-grid/node_upgrade.sh {slave|slave_public}
  • commit the upgrade on the bootstrap node.
$ /opt/dcos-grid/bootstrap_upgrade.sh -c

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.

Dependent cookbooks

docker-grid >= 0.2.1

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

dcos-grid CHANGELOG

0.4.8

  • adds ['dcos-grid']['dcos_release_script_name'] attribute.
  • adds dcos-grid::universe-build-env recipe.

0.4.7

  • improves the bootstrap node upgrade script.

0.4.6

  • bug fix.

0.4.5

  • refactors the upgrade scripts.

0.4.4

  • improves the upgrade scripts.

0.4.3

  • refactoring.
  • updates docker-grid cookbook dependency.
  • updates ['dcos-grid']['dcos_cli_release_url'] default value.
  • adds ['dcos-grid']['dcos_cli_upgrade'] attribute.
  • adds node upgrade scripts.

0.4.2

  • bug fix: generating genconf/config.yaml

0.4.1

  • updates docker-grid cookbook dependency.
  • adds ['dcos-grid']['bootstrap']['config']['telemetry_enabled'] attribute's default value 'false',

0.4.0

  • separates the docker-grid cookbook.

0.3.5

  • refactoring.
  • bug fix.

0.3.4

  • adds some attributes for Docker daemon's execution option.

0.3.3

  • improves configuration validation.

0.3.2

  • adds ['dcos-grid']['bootstrap']['config']['master_discovery'] default value.
  • adds some ['dcos-grid']['bootstrap']['config']['oauth_*'] attributes' default values.

0.3.1

  • adds some attributes of APT and YUM repositories' settings.
  • adds docker-engine version lock feature (by apt-pinning) on Ubuntu.

0.3.0

  • adds Ubuntu (>= 16.04) support (Experimental).
  • adds dcos-grid::cli recipe.

0.2.0

  • adds some attributes for the generation of cloud-config.yaml
  • improves the Markdown formatting of READEME.md

0.1.0

  • Initial release of dcos-grid

Collaborator Number Metric
            

0.4.8 failed this metric

Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Foodcritic Metric
            

0.4.8 passed this metric