shoot

Documentation

Index

• Constants
• Variables
• func ExpirationDateExpired(timestamp *metav1.Time) bool
• func ForceMachineImageUpdateRequired(shootCurrentImage *gardencorev1beta1.ShootMachineImage, ...) bool
• func GroupHibernationSchedulesByLocation(schedules []gardencorev1beta1.HibernationSchedule) map[string][]gardencorev1beta1.HibernationSchedule
• func LocationLogger(logger logrus.FieldLogger, location *time.Location) logrus.FieldLogger
• func MaintainKubernetesVersion(shoot *gardencorev1beta1.Shoot, profile *gardencorev1beta1.CloudProfile, ...) (updatedKubernetesVersion *string, messageKubernetesUpdate *string, error error)
• func MaintainMachineImages(logger *logrus.Entry, shoot *gardencorev1beta1.Shoot, ...) (updatedMachineImages []*gardencorev1beta1.ShootMachineImage, reasons []string, ...)
• func NewHibernationJob(clientMap clientmap.ClientMap, logger logrus.FieldLogger, ...) cron.Job
• func NewShootReferenceReconciler(l logrus.FieldLogger, clientMap clientmap.ClientMap, ...) reconcile.Reconciler
• type ConfigMapLister
• type Controller
  • func NewShootController(clientMap clientmap.ClientMap, ...) (*Controller, error)
  • func (c *Controller) CollectMetrics(ch chan<- prometheus.Metric)
  • func (c *Controller) Run(ctx context.Context, ...)
  • func (c *Controller) RunningWorkers() int
• type Cron
• type HibernationSchedule
  • func ComputeHibernationSchedule(clientMap clientmap.ClientMap, logger logrus.FieldLogger, ...) (HibernationSchedule, error)
  • func (h *HibernationSchedule) Start()
  • func (h *HibernationSchedule) Stop()
• type HibernationScheduleRegistry
  • func NewHibernationScheduleRegistry() HibernationScheduleRegistry
• type MaintenanceControlInterface
  • func NewDefaultMaintenanceControl(clientMap clientmap.ClientMap, ...) MaintenanceControlInterface
• type QuotaControlInterface
  • func NewDefaultQuotaControl(clientMap clientmap.ClientMap, ...) QuotaControlInterface
• type SecretLister

Constants

const FinalizerName = "gardener.cloud/reference-protection"

FinalizerName is the name of the finalizer used for the reference protection.

Variables

var (
	// NewCronWithLocation creates a new cron with the given location. Exposed for testing.
	NewCronWithLocation = newCronWithLocation

	// TimeNow returns the current time. Exposed for testing.
	TimeNow = time.Now
)

var (

	// UserManagedSelector is a selector for objects which are managed by users and not created by Gardener.
	UserManagedSelector = client.MatchingLabelsSelector{Selector: labels.NewSelector().Add(noGardenRole)}
)

Functions

func ExpirationDateExpired

func ExpirationDateExpired(timestamp *metav1.Time) bool

ExpirationDateExpired returns if now is equal or after the given expirationDate

func ForceMachineImageUpdateRequired

func ForceMachineImageUpdateRequired(shootCurrentImage *gardencorev1beta1.ShootMachineImage, imageCloudProvider gardencorev1beta1.MachineImage) bool

ForceMachineImageUpdateRequired checks if the shoots current machine image has to be forcefully updated

func GroupHibernationSchedulesByLocation

func GroupHibernationSchedulesByLocation(schedules []gardencorev1beta1.HibernationSchedule) map[string][]gardencorev1beta1.HibernationSchedule

GroupHibernationSchedulesByLocation groups the given HibernationSchedules by their Location. If the Location of a HibernationSchedule is `nil`, it is defaulted to UTC.

func LocationLogger

func LocationLogger(logger logrus.FieldLogger, location *time.Location) logrus.FieldLogger

LocationLogger returns a logger for the given location.

func MaintainKubernetesVersion

func MaintainKubernetesVersion(shoot *gardencorev1beta1.Shoot, profile *gardencorev1beta1.CloudProfile, logger *logrus.Entry) (updatedKubernetesVersion *string, messageKubernetesUpdate *string, error error)

MaintainKubernetesVersion determines if a shoots kubernetes version has to be maintained and in case returns the target version

func MaintainMachineImages

func MaintainMachineImages(logger *logrus.Entry, shoot *gardencorev1beta1.Shoot, cloudProfile *gardencorev1beta1.CloudProfile) (updatedMachineImages []*gardencorev1beta1.ShootMachineImage, reasons []string, error error)

MaintainMachineImages determines if a shoots machine images have to be maintained and in case returns the target images

func NewHibernationJob

func NewHibernationJob(clientMap clientmap.ClientMap, logger logrus.FieldLogger, recorder record.EventRecorder, target *gardencorev1beta1.Shoot, enabled bool) cron.Job

NewHibernationJob creates a new cron.Job that sets the hibernation of the given shoot to enabled when it triggers.

func NewShootReferenceReconciler

func NewShootReferenceReconciler(l logrus.FieldLogger, clientMap clientmap.ClientMap, userSecretLister SecretLister, configMapLister ConfigMapLister, config *config.ShootReferenceControllerConfiguration) reconcile.Reconciler

NewShootReferenceReconciler creates a new instance of a reconciler which checks object references from shoot objects. A special `userSecretLister` serves as an option to retrieve secret objects which are not gardener managed.

Types

type ConfigMapLister

type ConfigMapLister func(ctx context.Context, configMapList *corev1.ConfigMapList, options ...client.ListOption) error

ConfigMapLister fetches configmap objects with the given options.

type Controller

type Controller struct {
	// contains filtered or unexported fields
}

Controller controls Shoots.

func NewShootController

func NewShootController(clientMap clientmap.ClientMap, k8sGardenCoreInformers gardencoreinformers.SharedInformerFactory, kubeInformerFactory kubeinformers.SharedInformerFactory, config *config.ControllerManagerConfiguration, recorder record.EventRecorder) (*Controller, error)

NewShootController takes a ClientMap, a GardenerInformerFactory, a KubernetesInformerFactory, a ControllerManagerConfig struct and an EventRecorder to create a new Shoot controller.

func (*Controller) CollectMetrics

func (c *Controller) CollectMetrics(ch chan<- prometheus.Metric)

CollectMetrics implements gardenmetrics.ControllerMetricsCollector interface

func (*Controller) Run

func (c *Controller) Run(ctx context.Context, shootMaintenanceWorkers, shootQuotaWorkers, shootHibernationWorkers, shootReferenceWorkers int)

Run runs the Controller until the given stop channel can be read from.

func (*Controller) RunningWorkers

func (c *Controller) RunningWorkers() int

RunningWorkers returns the number of running workers.

type Cron

type Cron interface {
	Schedule(schedule cron.Schedule, job cron.Job)
	Start()
	Stop()
}

Cron is an interface that allows mocking cron.Cron.

type HibernationSchedule

type HibernationSchedule map[string]Cron

HibernationSchedule is a mapping from location to a Cron. It controls the hibernation process of a certain shoot.

func ComputeHibernationSchedule

func ComputeHibernationSchedule(clientMap clientmap.ClientMap, logger logrus.FieldLogger, recorder record.EventRecorder, shoot *gardencorev1beta1.Shoot) (HibernationSchedule, error)

ComputeHibernationSchedule computes the HibernationSchedule for the given Shoot.

func (*HibernationSchedule) Start

func (h *HibernationSchedule) Start()

Start implements Cron.

func (*HibernationSchedule) Stop

func (h *HibernationSchedule) Stop()

Stop implements Cron.

type HibernationScheduleRegistry

type HibernationScheduleRegistry interface {
	Load(key string) (schedule HibernationSchedule, ok bool)
	Store(key string, schedule HibernationSchedule)
	Delete(key string)
}

HibernationScheduleRegistry is a goroutine-safe mapping of Shoot key to HibernationSchedule.

func NewHibernationScheduleRegistry

func NewHibernationScheduleRegistry() HibernationScheduleRegistry

NewHibernationScheduleRegistry instantiates a new HibernationScheduleRegistry.

type MaintenanceControlInterface

type MaintenanceControlInterface interface {
	Maintain(shoot *gardencorev1beta1.Shoot, key string) error
}

MaintenanceControlInterface implements the control logic for maintaining Shoots. It is implemented as an interface to allow for extensions that provide different semantics. Currently, there is only one implementation.

func NewDefaultMaintenanceControl

func NewDefaultMaintenanceControl(clientMap clientmap.ClientMap, k8sGardenCoreInformers gardencoreinformers.Interface, config config.ShootMaintenanceControllerConfiguration, recorder record.EventRecorder) MaintenanceControlInterface

NewDefaultMaintenanceControl returns a new instance of the default implementation MaintenanceControlInterface that implements the documented semantics for maintaining Shoots. You should use an instance returned from NewDefaultMaintenanceControl() for any scenario other than testing.

type QuotaControlInterface

type QuotaControlInterface interface {
	CheckQuota(shoot *gardencorev1beta1.Shoot, key string) error
}

QuotaControlInterface implements the control logic for quota management of Shoots. It is implemented as an interface to allow for extensions that provide different semantics. Currently, there is only one implementation.

func NewDefaultQuotaControl

func NewDefaultQuotaControl(clientMap clientmap.ClientMap, k8sGardenCoreInformers gardencoreinformers.Interface) QuotaControlInterface

NewDefaultQuotaControl returns a new instance of the default implementation of QuotaControlInterface which implements the semantics for controlling the quota handling of Shoot resources.

type SecretLister

type SecretLister func(ctx context.Context, secretList *corev1.SecretList, options ...client.ListOption) error

SecretLister fetches secret objects with the given options.