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

The kubernetes cookbook has been deprecated

Author provided reason for deprecation:

The kubernetes cookbook has been deprecated and is no longer being maintained by its authors. Use of the kubernetes cookbook is no longer recommended.

You may find that the kube cookbook is a suitable alternative.


kubernetes (24) Versions 2.0.1

Resources for managing Kubernetes

cookbook 'kubernetes', '= 2.0.1', :supermarket
cookbook 'kubernetes', '= 2.0.1'
knife supermarket install kubernetes
knife supermarket download kubernetes
Quality 100%

kubernetes Cookbook

Build Status Cookbook Version

Resources for deploying various Kubernetes entities, these resources are designed to be ran on the kubernetes master but can be ran anywhere that has access to a kubernetes api by changing the ['kubernetes']['master']['ip'] attribute. These resources utilize the kubeclient ruby gem and run against the v1beta1 api.

Currently broken resources: (waiting on support for v1 api through kubeclient gem)

  • Kubernetes Pod (kube_pod)
  • Kubernetes Replication Controller (kube_replication_controller)
  • Kubernetes Service (kube_service)



  • All platforms where kubeclient gem can be installed


  • Chef 14+


  • build-essential


  • ['kubernetes']['master']['ip'] - the address used when contacting the kubernetes api
  • ['kubernetes']['master']['port'] - the port that will be used when contacting the kubernetes api
  • ['kubernetes']['client_version'] - the version of the kubeclient gem to install


Containers and Volumes

The syntax used when specifying containers and volumes is specific to the kubernetes api, for examples on what these can/should look like please see the kubernetes documentation/examples.


Theres a bit of magic in the helper library that allows you to specify labels as either a hash 'this' => 'that', 'app' => 'redis', an array of labels ['this=that','app=redis'], or a comma delimited string 'this=that,app=redis'. All three will be treated as the same thing when writing your resources.

License and Author

Copyright 2015, 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

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

This cookbook has no specified dependencies.

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

kubernetes Cookbook CHANGELOG

This file is used to list changes made in each version of the kubernetes cookbook.

2.0.1 - 2021-11-03

  • Sous-Chefs adoption
  • Run test suites in GitHub Actions

2.0.0 - 2021-10-26

  • Enabled unified_mode for all resources
  • Dropped support for Chef < 15.3

1.0.2 - 2021-08-30

  • Standardise files with files in sous-chefs/repo-management

1.0.1 - 2021-06-01

Collaborator Number Metric

2.0.1 passed this metric

Contributing File Metric

2.0.1 passed this metric

Foodcritic Metric

2.0.1 passed this metric

No Binaries Metric

2.0.1 passed this metric

Testing File Metric

2.0.1 passed this metric

Version Tag Metric

2.0.1 passed this metric