gardener

Kubernetes API server extension and controller managing the full lifecycle of conformant Kubernetes clusters as a service on Alicloud, AWS, Azure, GCP, and OpenStack with minimal TCO.

Gardener

Gardener Logo

CI Build status
Slack channel #gardener
Go Report Card
GoDoc
CII Best Practices

Gardener implements the automated management and operation of Kubernetes clusters as a service and provides extensibility concepts which allow support for any cloud or infrastructure provider. Its main principle is to leverage Kubernetes concepts for all of its tasks.

In essence, Gardener is an extension API server that comes along with a bundle of custom controllers. It introduces new API objects in an existing Kubernetes cluster (which is called garden cluster) in order to use them for the management of end-user Kubernetes clusters (which are called shoot clusters). These shoot clusters are described via declarative cluster specifications which are observed by the controllers. They will bring up the clusters, reconcile their state, perform automated updates and make sure they are always up and running.

To accomplish these tasks reliably and to offer a certain quality of service, Gardener controls the main components of a Kubernetes cluster (etcd, API server, controller manager, scheduler). These so-called control plane components are hosted in Kubernetes clusters themselves (which are called seed clusters). This is the main difference compared to many other OSS cluster provisioning tools: The shoot clusters do not have dedicated master VMs. Instead, the control plane is deployed as a native Kubernetes workload into the seeds. This does not only effectively reduce the total cost of ownership but also allows easier implementations for "day-2 operations" (like cluster updates or robustness) by relying on all the mature Kubernetes features and capabilities.

Please find more information regarding the concepts and a detailed description of the architecture in our Gardener Wiki and our blog post on kubernetes.io.


K8s Conformance Test Coverage

Conformance test results of latest stable Gardener release, transparently visible at the CNCF test grid:, Provider/K8s, v1.17, v1.16, v1.15, v1.14, v1.13, v1.12, v1.11, v1.10, -----------, -----------, -----------, -----------, -----------, -----------, -----------, -----------, -----------, GCP, Gardener v1.17 Conformance Tests, Gardener v1.16 Conformance Tests, Gardener v1.15 Conformance Tests, Gardener v1.14 Conformance Tests, Gardener v1.13 Conformance Tests, Gardener v1.12 Conformance Tests, Gardener v1.11 Conformance Tests, Gardener v1.10 Conformance Tests, AWS, Gardener v1.17 Conformance Tests, Gardener v1.16 Conformance Tests, Gardener v1.15 Conformance Tests, Gardener v1.14 Conformance Tests, Gardener v1.13 Conformance Tests, Gardener v1.12 Conformance Tests, Gardener v1.11 Conformance Tests, Gardener v1.10 Conformance Tests, OpenStack, Gardener v1.17 Conformance Tests, Gardener v1.16 Conformance Tests, Gardener v1.15 Conformance Tests, Gardener v1.14 Conformance Tests, Gardener v1.13 Conformance Tests, Gardener v1.12 Conformance Tests, Gardener v1.11 Conformance Tests, Gardener v1.10 Conformance Tests, Azure, Gardener v1.17 Conformance Tests, Gardener v1.16 Conformance Tests, Gardener v1.15 Conformance Tests, Gardener v1.14 Conformance Tests, Gardener v1.13 Conformance Tests, Gardener v1.12 Conformance Tests, Gardener v1.11 Conformance Tests, Gardener v1.10 Conformance Tests, Alicloud, Gardener v1.17 Conformance Tests, Gardener v1.16 Conformance Tests, Gardener v1.15 Conformance Tests, Gardener v1.14 Conformance Tests, Gardener v1.13 Conformance Tests, N/A, N/A, N/A, Packet, N/A, N/A, N/A, N/A, N/A, N/A, N/A, N/A, Besides the conformance tests, over 400 additional e2e tests are executed on a daily basis. Get an overview of the test results at testgrid.

Start using or developing the Gardener locally

See our documentation in the /docs repository, please find the index here.

Setting up your own Gardener landscape in the Cloud

The quickest way to test drive Gardener is to install it virtually onto an existing Kubernetes cluster, just like you would install any other Kubernetes-ready application. Launch your automatic installer here

We also have a Gardener Helm Chart. Alternatively you can use our garden setup project to create a fully configured Gardener landscape which also includes our Gardener Dashboard.

Feedback and Support

Feedback and contributions are always welcome!

All channels for getting in touch or learning about our project are listed under the community section. We are cordially inviting interested parties to join our weekly meetings.

Please report bugs or suggestions about our Kubernetes clusters as such or the Gardener itself as GitHub issues or join our Slack channel #gardener (please invite yourself to the Kubernetes workspace here).

Learn More!

Please find further resources about out project here:

Main metrics

Overview
Name With Ownergardener/gardener
Primary LanguageGo
Program languageMakefile (Language Count: 7)
Platform
License:Apache License 2.0
所有者活动
Created At2018-01-13 20:57:47
Pushed At2025-04-22 17:17:25
Last Commit At2025-04-22 20:17:25
Release Count643
Last Release Namev1.117.0 (Posted on )
First Release Name0.1.0 (Posted on 2018-03-21 08:32:31)
用户参与
Stargazers Count3.1k
Watchers Count72
Fork Count509
Commits Count11.7k
Has Issues Enabled
Issues Count2016
Issue Open Count91
Pull Requests Count8892
Pull Requests Open Count20
Pull Requests Close Count914
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private