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

RSS

kubernetes-install (5) Versions 0.0.10

Installs/Configures kubernetes

Berkshelf/Librarian
Policyfile
Knife
cookbook 'kubernetes-install', '~> 0.0.10'
cookbook 'kubernetes-install', '~> 0.0.10', :supermarket
knife cookbook site install kubernetes-install
knife cookbook site download kubernetes-install
README
Dependencies
Changelog
Quality 44%

kubernetes-install cookbook

The Kubernetes Cookbook install kubernetesat master and nodes using kubernetes-install::masterand kubernetes-install::node

Supported Platforms

This cookbook is intended to be used with Linux using systemd. SysV, Init.d and Upstart are not supported.

This cookbook expose no resources, all configuration is done through attributes.

Attributes

All attributes referring to parameters of kubernetes binaries can be informed by adding your own arguments to the root attribute.

i.e.:

node.kubernetes.kubelet.params['newparam']='value'
Key Type Description Default
['kubernetes']['package'] String URL to compressed package "https://github.com/kubernetes/kubernetes/releases/download/v1.1.1/kubernetes.tar.gz"
['kubernetes']['nodes'] Array Array of nodes []
['kubernetes']['internal_protocol'] String http or https 'http'
['kubernetes']['apiserver']['params']['address'] String See apiserver params '0.0.0.0'
['kubernetes']['apiserver']['params']['cloud-provider'] String See apiserver params
['kubernetes']['apiserver']['params']['cloud-config'] String See apiserver params
['kubernetes']['apiserver']['params']['insecure_port'] Integer See apiserver params 8080
['kubernetes']['apiserver']['params']['secure_port'] Integer See apiserver params 6443
['kubernetes']['apiserver']['params']['etcd_servers'] String See apiserver params 'http://127.0.0.1:4001'
['kubernetes']['apiserver']['params']['logtostderr'] Boolean See apiserver params true
['kubernetes']['apiserver']['params']['allow_privileged'] Boolean See apiserver params true
['kubernetes']['apiserver']['params']['kubelet_port'] Integer See apiserver params 10250
['kubernetes']['apiserver']['params']['v'] Integer See apiserver params 100
['kubernetes']['apiserver']['params']['kubelet_https'] Boolean See apiserver params true
['kubernetes']['apiserver']['params']['service-cluster-ip-range'] String See apiserver params '172.30.0.0/16'
['kubernetes']['apiserver']['params']['tls_cert_file'] String See apiserver params
['kubernetes']['apiserver']['params']['tls_private_key_file'] String See apiserver params
['kubernetes']['apiserver']['params']['client_ca_file'] String See apiserver params
['kubernetes']['apiserver']['params']['insecure_port'] Integer See apiserver params depends on internal protocol
['kubernetes']['master_list'] String Comma separated list of masters
['kubernetes']['kubelet']['params']['address'] String See kubelet params '0.0.0.0'
['kubernetes']['kubelet']['params']['port'] Integer See kubelet params 10250
['kubernetes']['kubelet']['params']['v'] Integer See kubelet params 100
['kubernetes']['kubelet']['params']['cadvisor-port'] Integer See kubelet params 4194
['kubernetes']['kubelet']['params']['cluster-dns'] String See kubelet params '172.30.3.1'
['kubernetes']['kubelet']['params']['cluster-domain'] String See kubelet params 'cluster.local'
['kubernetes']['kubelet']['params']['hostname-override'] String See kubelet params node["fqdn"]
['kubernetes']['kubelet']['params']['docker_endpoint'] String See kubelet params 'unix:///var/run/docker.sock'
['kubernetes']['kubelet']['params']['logtostderr'] Boolean See kubelet params true
['kubernetes']['kubelet']['params']['api_servers'] String See kubelet params node['kubernetes']['master_list']
['kubernetes']['controller']['params']['master'] String See rc params '127.0.0.1:8080'
['kubernetes']['controller']['params']['cloud-provider'] String See rc params
['kubernetes']['controller']['params']['cloud-config'] String See rc params
['kubernetes']['controller']['params']['v'] Integer See rc params 100
['kubernetes']['controller']['params']['logtostderr'] Boolean See rc params true
['kubernetes']['scheduler']['params']['master'] String See scheduler params '127.0.0.1:8080'
['kubernetes']['scheduler']['params']['v'] Integer See scheduler params 100
['kubernetes']['scheduler']['params']['logtostderr'] Boolean See scheduler params true
['kubernetes']['proxy']['params']['master'] String See kube-proxy params '127.0.0.1:8080'
['kubernetes']['proxy']['params']['v'] Integer See kube-proxy params 100
['kubernetes']['proxy']['params']['logtostderr'] Boolean See kube-proxy params true
['kubernetes']['proxy']['params']['master'] String See kube-proxy params node['kubernetes']['master_list']

Pre-requisites

All nodes must be running docker daemon with a configured overlay network.

  • This cookbook has only been tested with docker containers.
  • This cookbook has only been tested with weave overlay network.

Usage

To create a kubernetes cluster you need one master and at least one node. Although several masters are supported only clusters with a master node has been tested.

The run-list for the master must include 'kubernetes-install::master', with an override of the parameters that configure the environment. The attribute ['kubernetes']['nodes'] holds the array of operational nodes. At boot time this attribute should be empty.

The node nodes must include 'kubernetes-install:node' in their run-list. Once the node is operational, update the ['kubernetes']['nodes'] attribute for the master node at the Chef server, so that the node can be registered.

When removing a node node, be sure to also remove the node from the attribute, so the master doesn't try to reconfigure the missing member.

Cluster management

The kubernetes cluster can be managed using kubectl with the only limitation of managing nodes. Although we discourage using kubectl to add or remove nodes, if you need to use it you should also update the ['kubernetes']['nodes'] with the array of active nodes.

Recipes

kubernetes-install::master

Include kubernetes-install::master in your kubernetes master run list and make sure you boot it before the nodes.

  • The kubernetes version is determined by the compressed bundle package in ['kubernetes']['package'] attribute.
  • Binaries are located at /opt/kubernetes/server/bin/.
  • Services are created and started for every master binary (kube-apiserver, kube-controller-manager, kube-scheduler, kube-proxy).
  • Service discovery is managed through a SkyDNS pod.

kubernetes-install::node

Include kubernetes-install::node in your kubernetes nodes run list.

  • The kubernetes version is determined by the compressed bundle package in ['kubernetes']['package'] attribute
  • Binaries are located at /opt/kubernetes/server/bin/
  • Services are created and started for every master binary (kubelet, kube-proxy).

Dependent cookbooks

docker = 1.1.49
tar >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

0.1.0

Initial release of kubernetes-install

Collaborator Number Metric
            

0.0.10 passed this metric

Contributing File Metric
            

0.0.10 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file

Foodcritic Metric
            

0.0.10 failed this metric

FC066: Ensure chef_version is set in metadata: kubernetes-install/metadata.rb:1
FC069: Ensure standardized license defined in metadata: kubernetes-install/metadata.rb:1
FC072: Metadata should not contain "attribute" keyword: kubernetes-install/metadata.rb:1
Run with Foodcritic Version 12.2.1 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

License Metric
            

0.0.10 failed this metric

kubernetes-install does not have a valid open source license.
Acceptable licenses include Apache-2.0, apachev2, Apache 2.0, MIT, mit, GPL-2.0, gplv2, GNU Public License 2.0, GPL-3.0, gplv3, GNU Public License 3.0.

No Binaries Metric
            

0.0.10 passed this metric

Publish Metric
            

0.0.10 passed this metric

Supported Platforms Metric
            

0.0.10 passed this metric

Testing File Metric
            

0.0.10 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric
            

0.0.10 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number