kubernetes

The module installs and configures a Kubernetes cluster

856,398 downloads

485 latest version

3.1 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 8.1.0 (latest)
  • 8.0.0
  • 7.1.1
  • 7.1.0
  • 7.0.0
  • 6.3.0
  • 6.2.0
  • 6.1.0
  • 6.0.0
  • 5.5.0
  • 5.4.0
  • 5.3.0
  • 5.2.0
  • 5.1.0
  • 5.0.0
  • 4.0.1
  • 4.0.0
  • 3.4.0
  • 3.3.0
  • 3.2.2
  • 3.2.1
  • 3.2.0
  • 3.1.0
  • 3.0.1
  • 3.0.0
  • 2.0.2
  • 2.0.1
  • 2.0.0
  • 1.1.0
  • 1.0.3
  • 1.0.2
  • 1.0.1
  • 1.0.0
  • 0.2.0
  • 0.1.4
  • 0.1.3
  • 0.1.2
  • 0.1.1
  • 0.1.0
released May 26th 2023
This version is compatible with:
  • Puppet Enterprise 2023.2.x, 2023.1.x, 2021.7.x
  • Puppet >= 7.24.0 < 8.0.0
  • , , ,
Tasks:
  • swagger_k8s_list_extensions_v1beta1_replica_set_for_all_namespaces
  • swagger_k8s_list_networking_v1_network_policy_for_all_namespaces
  • swagger_k8s_list_networking_v1beta1_ingress_for_all_namespaces
  • swagger_k8s_list_node_v1alpha1_runtime_class
  • swagger_k8s_list_node_v1beta1_runtime_class
  • swagger_k8s_delete_admissionregistration_v1beta1_collection_mutating_webhook_configuration
  • swagger_k8s_delete_admissionregistration_v1beta1_collection_validating_webhook_configuration
  • and 521 more. See all tasks

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'puppetlabs-kubernetes', '7.1.1'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add puppetlabs-kubernetes
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install puppetlabs-kubernetes --version 7.1.1

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

puppetlabs/kubernetes — version 7.1.1 May 26th 2023

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

v7.1.1 - 2023-05-26

Full Changelog

Fixed

v7.1.0 - 2023-01-27

Full Changelog

Added

v7.0.0 - 2022-12-15

Full Changelog

Added

  • Support overriding containerd socket path (#596) #597 (deric)
  • Rewrite command line arguments parsing #593 (deric)
  • add new parameter containerd_sandbox_image #587 (BaronMsk)
  • Add RedHat family as supported OS (#563) #577 (deric)
  • Support Debian 11 #568 (deric)
  • Support changing bits used for generating certificates #566 (deric)
  • Add proxy support to docker, cri_containerd and kubelet #561 (nickperry)
  • Remove cgroup-driver arg to avoid deprecation warnings #540 (treydock)

Changed

  • Validate namespace parameter as DNS subdomain name #602 (deric)
  • (MAINT) Fixing codebase hardening issues #590 (LukasAud)

Fixed

  • Stronger type checking for $node_name #600 (deric)
  • (MAINT) Revert hardening changes #599 (chelnak)
  • Fix executing CNI addons commands (fixes #594) #598 (deric)
  • Addressing wrong type for unless execs #592 (LukasAud)
  • Fix Build docker image tooling #589 (BaronMsk)
  • (CONT-217) Correct Kubernetes etcd_data_dir spec tests #582 (GSPatton)
  • etcd data dir path configurable by hiera #581 (GSPatton)
  • Hardening manifest classes #575 (LukasAud)
  • Master role has been deprecated since kubernetes v1.20.0 #571 (deric)
  • Don't try to guess docker_version (#564) #565 (deric)
  • fix: anchor regex for determining config_version #554 (TheMeier)
  • pdksync - (GH-iac-334) Remove Support for Ubuntu 16.04 #548 (david22swan)
  • Fix #541 #542 (nickperry)
  • Update Debian-family docker repo location and key id #535 (jorhett)

v6.3.0 - 2021-09-06

Full Changelog

Added

  • Support Kubernetes 1.22 and kubeadm v1beta3 configurations #531 (treydock)
  • Enable live-restore for Docker daemon. #530 (peteroruba)

v6.2.0 - 2021-07-19

Full Changelog

Added

  • Allow configuring of waiting times during sa creation #519 (ZloeSabo)

Fixed

  • Support for kubernetes dashboard version 2.0.0 and onwards #528 (danifr)
  • Support both standard Calico and Calico Tigera #511 (treydock)

v6.1.0 - 2021-05-11

Full Changelog

Added

  • Add config.toml for containerd installed with 'archive' #516 (danifr)
  • Improvements to containerd configs when using a package #510 (treydock)
  • Add kubeadm skip-phases option #507 (BaronMsk)
  • Configure image registry settings for containerd when installed via package #500 (andeman)

Fixed

v6.0.0 - 2021-03-02

Full Changelog

Added

Changed

  • pdksync - Remove Puppet 5 from testing and bump minimal version to 6.0.0 #480 (carabasdaniel)

Fixed

v5.5.0 - 2020-12-16

Full Changelog

Added

v5.4.0 - 2020-11-30

Full Changelog

Added

  • Add scheduler_extra_arguments parameter #451 (treydock)
  • Add configuration options for conntrack settings in v1beta1 and v1beta2 #447 (Wiston999)
  • Implement advertise address for etcd #443 (faxm0dem)

Fixed

v5.3.0 - 2020-09-02

Full Changelog

Added

  • pdksync - (IAC-973) - Update travis/appveyor to run on new default branch main #428 (david22swan)
  • Package pinning and auto restart of etcd #420 (scoopex)
  • Delegated PKI and adapt to k8s 1.15.3+ #412 (Wiston999)
  • Add option to set the dns domain in kubernetes cluster #405 (BaronMsk)

Fixed

v5.2.0 - 2020-05-13

Full Changelog

Added

Fixed

  • Create client certificates per server with SAN values #382 (AblionGE)

v5.1.0 - 2020-01-27

Full Changelog

Added

  • Allow setting metricsBindAddress #377 (TJM)
  • Add docker_extra_daemon_config for use when managing docker #376 (mrwulf)
  • Add support for managing Docker logging max-file and max-size settings. #358 (nickperry)
  • Add possibility to run acceptance tests with Litmus and Vagrant #353 (carabasdaniel)
  • Add_support_1.16 #351 (BaronMsk)

Fixed

  • Fix worker k8s 1.6 #363 (BaronMsk)
  • Configure extra_volumes when cloud_provider is set and cloud_config is not. Fixes #301 #361 (nickperry)
  • Add support for readOnly and pathType fields on volumes #359 (nickperry)
  • Adding all IPs for etcd servers to etcd server cert #350 (blodone)
  • repair/improve package installation #348 (scoopex)
  • Use correct apt release on Debian/Ubuntu #338 (aptituz)
  • Fix repository location for Ubuntu #337 (aptituz)
  • Fixed v1beta1 JoinConfiguration template to match the documentation #332 (Xartos)

v5.0.0 - 2019-07-24

Full Changelog

Added

  • Modify config_version to kubernetes_version mapping. Pre-req to supporting Kube 1.15 #308 (nickperry)
  • add support for cilium network provider #265 (SimonHoenscheid)

Changed

Fixed

v4.0.1 - 2019-05-14

Full Changelog

Fixed

  • Add extra arguments for API server and controller manager #282 (fydai)
  • cluster name missing tag brackets in worker config #280 (jorhett)
  • Avoid log message about waiting for SA when it already exists #278 (jorhett)
  • MODULES-8947 fixing bugs and tests #274 (sheenaajay)

4.0.0 - 2019-04-17

Full Changelog

Added

Other

  • Tasks 1.14 - add new tasks for version v1beta1, update changelog and metadata #273 (lionce)
  • Etcd hostname variable #271 (sw0x2A)
  • add in logo for certified k8s installer #268 (davejrt)
  • introduce kubernetes_dashboard_url param #266 (SimonHoenscheid)
  • removes redundant variables in the case of not using the cloud provider #264 (davejrt)

3.4.0 - 2019-03-21

Full Changelog

Other

3.3.0 - 2019-03-14

Full Changelog

Other

  • release 3.3.0 #262 (davejrt)
  • Make kubectl environment available in main class #261 (jorhett)
  • Store cgroup driver in kubeadm configuration file for kubernetes 1.12+ #259 (jorhett)
  • Add support to change kubernetes cluster name #255 (jorhett)
  • Restructure kubenetes::config to kubenetes::config::kubeadm #254 (jorhett)
  • Safe command lines for CNI network installs #253 (jorhett)
  • Workaround race condition on default sa creation #247 (jorhett)

3.2.2 - 2019-02-12

Full Changelog

Other

3.2.1 - 2019-02-07

Full Changelog

Other

  • Update CHANGELOG.md #249 (davejrt)
  • restricts access to kube dirs to root only #248 (davejrt)
  • Allow setting etcd initial cluster state #246 (clly)
  • Remove dependency on puppet-wget (use puppet-archive instead) #243 (JayH5)

3.2.0 - 2019-01-23

Full Changelog

Other

  • updating changelog and metadata for 3.2.0 release #240 (davejrt)
  • Mount cloud configuration on ApiServer and ControllerManager pods #236 (jorhett)
  • Fix alpha3 template #235 (jorhett)
  • Use fact method to more gracefully handle missing facts #234 (ralimi)
  • Honor overridden service address range in alpha3 config. #233 (ralimi)
  • Fix systemd cpu/memory problems on RedHat #230 (jorhett)
  • updating calico URL #229 (davejrt)
  • Dashboard no longer has deploy YAML on master branch #228 (jorhett)
  • Fix cni network provider #227 (keur)
  • Reduce redundant test fill by using Hiera for default values #226 (jorhett)
  • Fix CentOS repos #225 (jorhett)
  • Build config file for worker nodes too #224 (jorhett)
  • Fix cloud_provider hostnames #223 (jorhett)
  • Defer os-specific default value test to avoid fact availability issues #222 (jorhett)
  • Update go version #220 (davejrt)
  • Fix multiple errors in cloud configuration #219 (jorhett)
  • enable kubelet service #215 (davejrt)
  • updates for puppet 6 #214 (davejrt)
  • adding in logic for managing kmod alternatively #213 (davejrt)
  • Remove legacy facts #212 (SimonHoenscheid)
  • Move kubernetesVersion into ClusterConfiguration #210 (nickperry)
  • adding in ordering for sysctl to present failures #206 (davejrt)
  • document manage_kernel_modules and manage_sysctl_settings, remove doc… #205 (SimonHoenscheid)
  • removes redundant variable and fixes error with to_yaml #201 (davejrt)
  • fixing alignment in init.pp and problem with variables in config3 #200 (davejrt)
  • fix fixtures.yaml, set right author/source for wget module #199 (SimonHoenscheid)
  • Add support for configuring kubeletExtraArgs in v1alpha3 config. #198 (nickperry)
  • Move parameter definition back to head of init.pp (fixes #169) #193 (temujin9)
  • Remove Execs for Kmod management and setting Sysctl values with accor… #192 (SimonHoenscheid)

3.1.0 - 2018-11-14

Full Changelog

Other

3.0.1 - 2018-08-31

Full Changelog

Other

3.0.0 - 2018-08-22

Full Changelog

Other

  • Fix module hard requirement for apt to < 6.0.0 #153 (meltingrobot)
  • (maint) Updated .sync.yml #150 (bmjen)
  • (CLOUD-2054) Readme updates. #149 (EamonnTP)
  • (CLOUD-1978) pdk changes for k8 module #148 (sheenaajay)
  • Flatten fix #146 (davejrt)
  • Add feature flag for managing Docker repositories and packages #144 (jonasdemoor)
  • Cleaning up apiServerExtraArgs #143 (mrwulf)
  • Fixed indenting issue when configuring multiple extra apiserver cert SANs #142 (yoshz)
  • Allow arbitrary extra kubeadm config.yaml snippets #141 (Zetten)
  • adding in tests for cloud provider in service class #140 (davejrt)
  • updating readme with new params #139 (davejrt)
  • adds in param to configure rbac for calico #137 (davejrt)
  • disables swap #136 (davejrt)
  • adding in puppet wget module #135 (davejrt)
  • paramaters for different upstream repos and OS flavors #134 (davejrt)
  • adds in the option to disable repo install, or override repos and URLs for offline installs #133 (davejrt)
  • fix wrong folder name #132 (khaefeli)
  • Fixed missing cloud provider arguments for kubelet #131 (yoshz)
  • Clean up README #129 (alexharv074)
  • kubernetes::cluster_roles - ignore CNI errors on kubeadm join #127 (tskirvin)
  • Update metadata.json #125 (davejrt)
  • Fix for failing idempotency on worker nodes #120 (AranVinkItility)
  • Revert "Fix error: parameter 'api_server_count' expects an Integer value, got…" #115 (davejrt)
  • Fix error: parameter 'api_server_count' expects an Integer value, got… #113 (Lord-Y)
  • release updates #110 (davejrt)

2.0.2 - 2018-06-04

Full Changelog

Other

  • fixes issue with cgroup mismatch on rhel and ignore flags for containerd runtime #109 (davejrt)
  • prepping for release #108 (davejrt)

2.0.1 - 2018-06-01

Full Changelog

Other

2.0.0 - 2018-06-01

Full Changelog

Other

  • README.md - use current version number #101 (tskirvin)
  • calico is actually supported #99 (KlavsKlavsen)
  • bumping version in metadata.json and updating changelog #94 (davejrt)
  • Allow mounting extra volumes to apiserver pod #89 (Zetten)
  • Pin versions of debian packages #86 (admont)

1.1.0 - 2018-04-15

Full Changelog

Added

  • Expose a lot of params - mostly to ease deployments in a different overlay network range #82 (mrwulf)

Other

1.0.3 - 2018-02-14

Full Changelog

Other

1.0.2 - 2018-01-31

Full Changelog

Other

  • Fix to stop RHEL family downgrading cni #55 (scotty-c)
  • Revert "(CLOUD-1640) Remove package resource for kubernetes-cni" #54 (scotty-c)
  • (CLOUD-1640) Remove package resource for kubernetes-cni #53 (abottchen)

1.0.1 - 2018-01-30

Full Changelog

Other

1.0.0 - 2018-01-09

Full Changelog

Other

0.2.0 - 2017-12-19

Full Changelog

Added

Other

0.1.4 - 2017-11-28

Full Changelog

Other

0.1.3 - 2017-11-27

Full Changelog

Other

0.1.2 - 2017-11-18

Full Changelog

Other

0.1.1 - 2017-11-15

Full Changelog

Other

0.1.0 - 2017-10-11

Full Changelog