shoot

Documentation

Index

• Variables
• func ExpirationDateExpired(timestamp *metav1.Time) bool
• func ForceMachineImageUpdateRequired(shootCurrentImage *gardencorev1alpha1.ShootMachineImage, ...) bool
• func GroupHibernationSchedulesByLocation(schedules []gardencorev1alpha1.HibernationSchedule) map[string][]gardencorev1alpha1.HibernationSchedule
• func LocationLogger(logger logrus.FieldLogger, location *time.Location) logrus.FieldLogger
• func MaintainKubernetesVersion(shoot *gardencorev1alpha1.Shoot, profile *gardencorev1alpha1.CloudProfile) (*string, error)
• func MaintainMachineImages(shoot *gardencorev1alpha1.Shoot, cloudProfile *gardencorev1alpha1.CloudProfile, ...) ([]*gardencorev1alpha1.ShootMachineImage, error)
• func NewHibernationJob(client gardencore.Interface, logger logrus.FieldLogger, ...) cron.Job
• func StatusLabelTransform(status Status) func(*gardencorev1alpha1.Shoot) (*gardencorev1alpha1.Shoot, error)
• type CareControlInterface
  • func NewDefaultCareControl(k8sGardenClient kubernetes.Interface, ...) CareControlInterface
• type Controller
  • func NewShootController(k8sGardenClient kubernetes.Interface, ...) *Controller
  • func (c *Controller) CollectMetrics(ch chan<- prometheus.Metric)
  • func (c *Controller) Run(ctx context.Context, ...)
  • func (c *Controller) RunningWorkers() int
• type ControllerInstallationControlInterface
  • func NewDefaultControllerInstallationControl(k8sGardenClient kubernetes.Interface, ...) ControllerInstallationControlInterface
• type Cron
• type HibernationSchedule
  • func ComputeHibernationSchedule(client gardencore.Interface, logger logrus.FieldLogger, ...) (HibernationSchedule, error)
  • func (h *HibernationSchedule) Start()
  • func (h *HibernationSchedule) Stop()
• type HibernationScheduleRegistry
  • func NewHibernationScheduleRegistry() HibernationScheduleRegistry
• type MaintenanceControlInterface
  • func NewDefaultMaintenanceControl(k8sGardenClient kubernetes.Interface, ...) MaintenanceControlInterface
• type QuotaControlInterface
  • func NewDefaultQuotaControl(k8sGardenClient kubernetes.Interface, ...) QuotaControlInterface
• type Status
  • func BoolToStatus(cond bool) Status
  • func ComputeConditionStatus(conditions ...gardencorev1alpha1.Condition) Status
  • func ComputeStatus(lastOperation *gardencorev1alpha1.LastOperation, ...) Status
  • func ConditionStatusToStatus(status gardencorev1alpha1.ConditionStatus) Status
  • func (s Status) OrWorse(other Status) Status

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
)

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 *gardencorev1alpha1.ShootMachineImage, imageCloudProvider gardencorev1alpha1.MachineImage) bool

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

func GroupHibernationSchedulesByLocation

func GroupHibernationSchedulesByLocation(schedules []gardencorev1alpha1.HibernationSchedule) map[string][]gardencorev1alpha1.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 *gardencorev1alpha1.Shoot, profile *gardencorev1alpha1.CloudProfile) (*string, error)

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

func MaintainMachineImages

func MaintainMachineImages(shoot *gardencorev1alpha1.Shoot, cloudProfile *gardencorev1alpha1.CloudProfile, shootCurrentImages []*gardencorev1alpha1.ShootMachineImage) ([]*gardencorev1alpha1.ShootMachineImage, error)

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

func NewHibernationJob

func NewHibernationJob(client gardencore.Interface, logger logrus.FieldLogger, target *gardencorev1alpha1.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 StatusLabelTransform

func StatusLabelTransform(status Status) func(*gardencorev1alpha1.Shoot) (*gardencorev1alpha1.Shoot, error)

StatusLabelTransform transforms the shoot labels depending on the given Status.

Types

type CareControlInterface

type CareControlInterface interface {
	Care(shoot *gardencorev1alpha1.Shoot, key string) error
}

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

func NewDefaultCareControl

func NewDefaultCareControl(k8sGardenClient kubernetes.Interface, k8sGardenCoreInformers gardencoreinformers.Interface, secrets map[string]*corev1.Secret, imageVector imagevector.ImageVector, identity *gardencorev1alpha1.Gardener, config *config.ControllerManagerConfiguration) CareControlInterface

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

type Controller

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

Controller controls Shoots.

func NewShootController

func NewShootController(k8sGardenClient kubernetes.Interface, k8sGardenCoreInformers gardencoreinformers.SharedInformerFactory, kubeInformerFactory kubeinformers.SharedInformerFactory, config *config.ControllerManagerConfiguration, identity *gardencorev1alpha1.Gardener, gardenNamespace string, secrets map[string]*corev1.Secret, imageVector imagevector.ImageVector, recorder record.EventRecorder) *Controller

NewShootController takes a Kubernetes client for the Garden clusters <k8sGardenClient>, a struct holding information about the acting Gardener, a <shootInformer>, and a <recorder> for event recording. It creates a new Gardener 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, shootWorkers, shootCareWorkers, shootMaintenanceWorkers, shootQuotaWorkers, shootHibernationWorkers 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 ControllerInstallationControlInterface

type ControllerInstallationControlInterface interface {
	Reconcile(controllerInstallationObj *gardencorev1alpha1.ControllerInstallation) ([]*gardencorev1alpha1.Shoot, error)
}

ControllerInstallationControlInterface implements the control logic for requeuing Shoots after extensions have been updated. It is implemented as an interface to allow for extensions that provide different semantics. Currently, there is only one implementation.

func NewDefaultControllerInstallationControl

func NewDefaultControllerInstallationControl(k8sGardenClient kubernetes.Interface, k8sGardenCoreInformers gardencoreinformers.Interface, recorder record.EventRecorder) ControllerInstallationControlInterface

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

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(client gardencore.Interface, logger logrus.FieldLogger, shoot *gardencorev1alpha1.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 *gardencorev1alpha1.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(k8sGardenClient kubernetes.Interface, k8sGardenCoreInformers gardencoreinformers.Interface, secrets map[string]*corev1.Secret, imageVector imagevector.ImageVector, identity *gardencorev1alpha1.Gardener, 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 *gardencorev1alpha1.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(k8sGardenClient kubernetes.Interface, 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 Status

type Status string

Status is the status of a shoot used in the common.ShootStatus label.

const (
	// StatusHealthy indicates that a shoot is considered healthy.
	StatusHealthy Status = "healthy"
	// StatusProgressing indicates that a shoot was once healthy, currently experienced an issue
	// but is still within a predefined grace period.
	StatusProgressing Status = "progressing"
	// StatusUnhealthy indicates that a shoot is considered unhealthy.
	StatusUnhealthy Status = "unhealthy"
)

func BoolToStatus

func BoolToStatus(cond bool) Status

BoolToStatus converts the given boolean to a Status. For true values, it returns StatusHealthy. Otherwise, it returns StatusUnhealthy.

func ComputeConditionStatus

func ComputeConditionStatus(conditions ...gardencorev1alpha1.Condition) Status

ComputeConditionStatus computes a shoot Label Status from the given Conditions. By default, the Status is StatusHealthy. The condition status is converted to a Status by using ConditionStatusToStatus. Always the worst status of the combined states wins.

func ComputeStatus

func ComputeStatus(lastOperation *gardencorev1alpha1.LastOperation, lastErrors []gardencorev1alpha1.LastError, lastError *gardencorev1alpha1.LastError, conditions ...gardencorev1alpha1.Condition) Status

ComputeStatus computes the label Status of a shoot depending on the given lastOperation, lastError and conditions.

func ConditionStatusToStatus

func ConditionStatusToStatus(status gardencorev1alpha1.ConditionStatus) Status

ConditionStatusToStatus converts the given ConditionStatus to a shoot label Status.

func (Status) OrWorse

func (s Status) OrWorse(other Status) Status

OrWorse returns the worse Status of the given two states.