cookbook 'kubernetes', '~> 3.0.0'
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
(27) Versions
3.0.0
-
Follow11
Resources for managing Kubernetes
cookbook 'kubernetes', '~> 3.0.0', :supermarket
knife supermarket install kubernetes
knife supermarket download kubernetes
kubernetes cookbook
Manage Kubernetes Pods, Services and ReplicationControllers through the core/v1 API.
The cookbook connects to an existing cluster; it does not install Kubernetes.
Requirements
- Chef Infra Client 17 or later.
- A supported Ruby platform with the build tools needed by kubeclient's native dependencies.
- An operator-controlled kubeconfig with permission to manage the selected resources and namespace.
- An existing Kubernetes cluster exposing core/v1 with server-side apply (stable since Kubernetes 1.22).
Platform support remains independent of the cluster's operating system. Linux integration tests
cover maintained Debian, Ubuntu, RHEL derivatives, Amazon Linux, Fedora and openSUSE images.
Resources
- [kube_pod](documentation/kube_pod.md)
- [kube_service](documentation/kube_service.md)
- [kube_replication_controller](documentation/kube_replication_controller.md)
All resources accept [connection properties](documentation/connection.md). They create missing
objects, update managed fields when they differ, and leave API defaults intact. Authentication,
validation, immutable-field and connection errors fail convergence.
kube_service 'backend' do kubeconfig '/etc/chef/kubernetes.conf' namespace 'applications' port 80 container_port 8080 selector 'app=backend' end
Use :delete or the existing :destroy action to remove an object from the selected namespace.
Deleting one object does not remove its namespace, credentials or objects in other namespaces.
Upgrading
This is a full custom resource migration. Root node attributes and the removed v1beta1 payload
format are no longer supported. See [migration.md](migration.md) for connection and input changes.
Testing
See [TESTING.md](TESTING.md) for the real Kind-backed Kitchen workflow. Tests exercise creation,
updates, deletion, namespace isolation and a second converge with no changes.
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.
3.0.0 (2026-11-12)
⚠ BREAKING CHANGES
- replace node attributes and the removed v1beta1 API with explicit kubeconfig properties and core/v1 resources. Require Chef 17 or later. Preserve resource names and destroy actions, and add namespace-aware server-side apply with real cluster tests.
Features
Bug Fixes
- ci: Update workflows to use release pipeline (#68) (59676c1)
- repair workflow actionlint failures (#76) (fa106bf)
2.0.23 (2025-10-15)
Bug Fixes
2.0.13 - 2023-04-07
Standardise files with files in sous-chefs/repo-management
2.0.10 - 2023-04-01
Standardise files with files in sous-chefs/repo-management
2.0.9 - 2023-03-20
Standardise files with files in sous-chefs/repo-management
2.0.8 - 2023-03-15
Standardise files with files in sous-chefs/repo-management
2.0.6 - 2023-02-23
Standardise files with files in sous-chefs/repo-management
2.0.4 - 2023-02-14
Standardise files with files in sous-chefs/repo-management
2.0.3 - 2022-12-15
Standardise files with files in sous-chefs/repo-management
Standardise files with files in sous-chefs/repo-management
- Update Test Kitchen provisioner settings
- Remove PID one command in Dokken
- These are all the defaults and we should use the correct container defaults
2.0.2 - 2022-02-07
- Remove delivery and move to calling RSpec directly via a reusable workflow
- Update tested platforms
- Standardise files with files in sous-chefs/repo-management
2.0.1 - 2021-11-03
- Sous-Chefs adoption
- Run test suites in GitHub Actions
2.0.0 - 2021-10-26
- Enabled
unified_modefor 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
3.0.0 passed this metric
Contributing File Metric
3.0.0 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
Cookstyle Metric
3.0.0 passed this metric
No Binaries Metric
3.0.0 passed this metric
Testing File Metric
3.0.0 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
3.0.0 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
3.0.0 passed this metric
3.0.0 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
Cookstyle Metric
3.0.0 passed this metric
No Binaries Metric
3.0.0 passed this metric
Testing File Metric
3.0.0 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
3.0.0 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
3.0.0 passed this metric
3.0.0 passed this metric
Testing File Metric
3.0.0 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
3.0.0 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
3.0.0 failed this metric
3.0.0 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