Skip to content

Seedmanagement ​

Packages:

seedmanagement.gardener.cloud/v1alpha1

Resource Types:

Bootstrap

Underlying type: string

(Appears on:GardenletConfig)

Bootstrap describes a mechanism for bootstrapping gardenlet connection to the Garden cluster.

Gardenlet

Gardenlet represents a Gardenlet configuration for an unmanaged seed.

Field Description
metadata
ObjectMeta
Refer to the Kubernetes API documentation for the fields of the metadata field.
spec
GardenletSpec
(Optional)

Specification of the Gardenlet.

status
GardenletStatus
(Optional)

Most recently observed status of the Gardenlet.

GardenletConfig

(Appears on:ManagedSeedSpec)

GardenletConfig specifies gardenlet deployment parameters and the GardenletConfiguration used to configure gardenlet.

Field Description
deployment
GardenletDeployment
(Optional)

Deployment specifies certain gardenlet deployment parameters, such as the number of replicas,
the image, etc.

config
RawExtension
(Optional)

Config is the GardenletConfiguration used to configure gardenlet.

bootstrap
Bootstrap
(Optional)

Bootstrap is the mechanism that should be used for bootstrapping gardenlet connection to the Garden cluster. One of ServiceAccount, BootstrapToken, None.
If set to ServiceAccount or BootstrapToken, a service account or a bootstrap token will be created in the garden cluster and used to compute the bootstrap kubeconfig.
If set to None, the gardenClientConnection.kubeconfig field will be used to connect to the Garden cluster. Defaults to BootstrapToken.
This field is immutable.

mergeWithParent
boolean
(Optional)

MergeWithParent specifies whether the GardenletConfiguration of the parent gardenlet
should be merged with the specified GardenletConfiguration. Defaults to true. This field is immutable.

GardenletDeployment

(Appears on:GardenletConfig, GardenletSelfDeployment)

GardenletDeployment specifies certain gardenlet deployment parameters, such as the number of replicas, the image, etc.

Field Description
replicaCount
integer
(Optional)

ReplicaCount is the number of gardenlet replicas. Defaults to 2.

revisionHistoryLimit
integer
(Optional)

RevisionHistoryLimit is the number of old gardenlet ReplicaSets to retain to allow rollback. Defaults to 2.

serviceAccountName
string
(Optional)

ServiceAccountName is the name of the ServiceAccount to use to run gardenlet pods.

image
Image
(Optional)

Image is the gardenlet container image.

resources
ResourceRequirements
(Optional)

Resources are the compute resources required by the gardenlet container.

podLabels
object (keys:string, values:string)
(Optional)

PodLabels are the labels on gardenlet pods.

podAnnotations
object (keys:string, values:string)
(Optional)

PodAnnotations are the annotations on gardenlet pods.

additionalVolumes
Volume array
(Optional)

AdditionalVolumes is the list of additional volumes that should be mounted by gardenlet containers.

additionalVolumeMounts
VolumeMount array
(Optional)

AdditionalVolumeMounts is the list of additional pod volumes to mount into the gardenlet container's filesystem.

env
EnvVar array
(Optional)

Env is the list of environment variables to set in the gardenlet container.

tolerations
Toleration array
(Optional)

Tolerations are the tolerations to be applied to gardenlet pods.

GardenletHelm

(Appears on:GardenletSelfDeployment)

GardenletHelm is the Helm deployment configuration for gardenlet.

Field Description
ociRepository
OCIRepository

OCIRepository defines where to pull the chart.

GardenletSelfDeployment

(Appears on:GardenletSpec)

GardenletSelfDeployment specifies certain gardenlet deployment parameters, such as the number of replicas, the image, etc.

Field Description
replicaCount
integer
(Optional)

ReplicaCount is the number of gardenlet replicas. Defaults to 2.

revisionHistoryLimit
integer
(Optional)

RevisionHistoryLimit is the number of old gardenlet ReplicaSets to retain to allow rollback. Defaults to 2.

serviceAccountName
string
(Optional)

ServiceAccountName is the name of the ServiceAccount to use to run gardenlet pods.

image
Image
(Optional)

Image is the gardenlet container image.

resources
ResourceRequirements
(Optional)

Resources are the compute resources required by the gardenlet container.

podLabels
object (keys:string, values:string)
(Optional)

PodLabels are the labels on gardenlet pods.

podAnnotations
object (keys:string, values:string)
(Optional)

PodAnnotations are the annotations on gardenlet pods.

additionalVolumes
Volume array
(Optional)

AdditionalVolumes is the list of additional volumes that should be mounted by gardenlet containers.

additionalVolumeMounts
VolumeMount array
(Optional)

AdditionalVolumeMounts is the list of additional pod volumes to mount into the gardenlet container's filesystem.

env
EnvVar array
(Optional)

Env is the list of environment variables to set in the gardenlet container.

tolerations
Toleration array
(Optional)

Tolerations are the tolerations to be applied to gardenlet pods.

helm
GardenletHelm

Helm is the Helm deployment configuration.

imageVectorOverwrite
string
(Optional)

ImageVectorOverwrite is the image vector overwrite for the components deployed by this gardenlet.

componentImageVectorOverwrite
string
(Optional)

ComponentImageVectorOverwrite is the component image vector overwrite for the components deployed by this
gardenlet.

GardenletSpec

(Appears on:Gardenlet)

GardenletSpec specifies gardenlet deployment parameters and the configuration used to configure gardenlet.

Field Description
deployment
GardenletSelfDeployment

Deployment specifies certain gardenlet deployment parameters, such as the number of replicas,
the image, etc.

config
RawExtension
(Optional)

Config is the GardenletConfiguration used to configure gardenlet.

kubeconfigSecretRef
LocalObjectReference
(Optional)

KubeconfigSecretRef is a reference to a secret containing a kubeconfig for the cluster to which gardenlet should
be deployed. This is only used by gardener-operator for a very first gardenlet deployment. After that, gardenlet
will continuously upgrade itself. If this field is empty, gardener-operator deploys it into its own runtime
cluster.

GardenletStatus

(Appears on:Gardenlet)

GardenletStatus is the status of a Gardenlet.

Field Description
conditions
Condition array
(Optional)

Conditions represents the latest available observations of a Gardenlet's current state.

observedGeneration
integer
(Optional)

ObservedGeneration is the most recent generation observed for this Gardenlet. It corresponds to the Gardenlet's
generation, which is updated on mutation by the API Server.

Image

(Appears on:GardenletDeployment, GardenletSelfDeployment)

Image specifies container image parameters. Either Repository/Tag or Ref must be set, but not both.

Field Description
repository
string
(Optional)

Repository is the image repository.

tag
string
(Optional)

Tag is the image tag.

pullPolicy
PullPolicy
(Optional)

PullPolicy is the image pull policy. One of Always, Never, IfNotPresent.
Defaults to Always if latest tag is specified, or IfNotPresent otherwise.

ref
string
(Optional)

Ref is the full image reference.

ManagedSeed

ManagedSeed represents a Shoot that is registered as Seed.

Field Description
metadata
ObjectMeta
Refer to the Kubernetes API documentation for the fields of the metadata field.
spec
ManagedSeedSpec
(Optional)

Specification of the ManagedSeed.

status
ManagedSeedStatus
(Optional)

Most recently observed status of the ManagedSeed.

ManagedSeedSet

ManagedSeedSet represents a set of identical ManagedSeeds.

Field Description
metadata
ObjectMeta
Refer to the Kubernetes API documentation for the fields of the metadata field.
spec
ManagedSeedSetSpec
(Optional)

Spec defines the desired identities of ManagedSeeds and Shoots in this set.

status
ManagedSeedSetStatus
(Optional)

Status is the current status of ManagedSeeds and Shoots in this ManagedSeedSet.

ManagedSeedSetSpec

(Appears on:ManagedSeedSet)

ManagedSeedSetSpec is the specification of a ManagedSeedSet.

Field Description
replicas
integer
(Optional)

Replicas is the desired number of replicas of the given Template. Defaults to 1.

selector
LabelSelector

Selector is a label query over ManagedSeeds and Shoots that should match the replica count.
It must match the ManagedSeeds and Shoots template's labels. This field is immutable.

template
ManagedSeedTemplate

Template describes the ManagedSeed that will be created if insufficient replicas are detected.
Each ManagedSeed created / updated by the ManagedSeedSet will fulfill this template.

shootTemplate
ShootTemplate

ShootTemplate describes the Shoot that will be created if insufficient replicas are detected for hosting the corresponding ManagedSeed.
Each Shoot created / updated by the ManagedSeedSet will fulfill this template.

updateStrategy
UpdateStrategy
(Optional)

UpdateStrategy specifies the UpdateStrategy that will be
employed to update ManagedSeeds / Shoots in the ManagedSeedSet when a revision is made to
Template / ShootTemplate.

revisionHistoryLimit
integer
(Optional)

RevisionHistoryLimit is the maximum number of revisions that will be maintained
in the ManagedSeedSet's revision history. Defaults to 10. This field is immutable.

ManagedSeedSetStatus

(Appears on:ManagedSeedSet)

ManagedSeedSetStatus represents the current state of a ManagedSeedSet.

Field Description
observedGeneration
integer

ObservedGeneration is the most recent generation observed for this ManagedSeedSet. It corresponds to the
ManagedSeedSet's generation, which is updated on mutation by the API Server.

replicas
integer

Replicas is the number of replicas (ManagedSeeds and their corresponding Shoots) created by the ManagedSeedSet controller.

readyReplicas
integer

ReadyReplicas is the number of ManagedSeeds created by the ManagedSeedSet controller that have a Ready Condition.

nextReplicaNumber
integer

NextReplicaNumber is the ordinal number that will be assigned to the next replica of the ManagedSeedSet.

currentReplicas
integer

CurrentReplicas is the number of ManagedSeeds created by the ManagedSeedSet controller from the ManagedSeedSet version
indicated by CurrentRevision.

updatedReplicas
integer

UpdatedReplicas is the number of ManagedSeeds created by the ManagedSeedSet controller from the ManagedSeedSet version
indicated by UpdateRevision.

currentRevision
string

CurrentRevision, if not empty, indicates the version of the ManagedSeedSet used to generate ManagedSeeds with smaller
ordinal numbers during updates.

updateRevision
string

UpdateRevision, if not empty, indicates the version of the ManagedSeedSet used to generate ManagedSeeds with larger
ordinal numbers during updates

collisionCount
integer
(Optional)

CollisionCount is the count of hash collisions for the ManagedSeedSet. The ManagedSeedSet controller
uses this field as a collision avoidance mechanism when it needs to create the name for the
newest ControllerRevision.

conditions
Condition array
(Optional)

Conditions represents the latest available observations of a ManagedSeedSet's current state.

pendingReplica
PendingReplica
(Optional)

PendingReplica, if not empty, indicates the replica that is currently pending creation, update, or deletion.
This replica is in a state that requires the controller to wait for it to change before advancing to the next replica.

ManagedSeedSpec

(Appears on:ManagedSeed, ManagedSeedTemplate)

ManagedSeedSpec is the specification of a ManagedSeed.

Field Description
shoot
Shoot
(Optional)

Shoot references a Shoot that should be registered as Seed.
This field is immutable.

gardenlet
GardenletConfig

Gardenlet specifies that the ManagedSeed controller should deploy a gardenlet into the cluster
with the given deployment parameters and GardenletConfiguration.

ManagedSeedStatus

(Appears on:ManagedSeed)

ManagedSeedStatus is the status of a ManagedSeed.

Field Description
conditions
Condition array
(Optional)

Conditions represents the latest available observations of a ManagedSeed's current state.

observedGeneration
integer

ObservedGeneration is the most recent generation observed for this ManagedSeed. It corresponds to the
ManagedSeed's generation, which is updated on mutation by the API Server.

ManagedSeedTemplate

(Appears on:ManagedSeedSetSpec)

ManagedSeedTemplate is a template for creating a ManagedSeed object.

Field Description
metadata
ObjectMeta
Refer to the Kubernetes API documentation for the fields of the metadata field.
spec
ManagedSeedSpec
(Optional)

Specification of the desired behavior of the ManagedSeed.

PendingReplica

(Appears on:ManagedSeedSetStatus)

PendingReplica contains information about a replica that is currently pending creation, update, or deletion.

Field Description
name
string

Name is the replica name.

reason
PendingReplicaReason

Reason is the reason for the replica to be pending.

since
Time

Since is the moment in time since the replica is pending with the specified reason.

retries
integer
(Optional)

Retries is the number of times the shoot operation (reconcile or delete) has been retried after having failed.
Only applicable if Reason is ShootReconciling or ShootDeleting.

PendingReplicaReason

Underlying type: string

(Appears on:PendingReplica)

PendingReplicaReason is a string enumeration type that enumerates all possible reasons for a replica to be pending.

RollingUpdateStrategy

(Appears on:UpdateStrategy)

RollingUpdateStrategy is used to communicate parameters for RollingUpdateStrategyType.

Field Description
partition
integer
(Optional)

Partition indicates the ordinal at which the ManagedSeedSet should be partitioned. Defaults to 0.

Shoot

(Appears on:ManagedSeedSpec)

Shoot identifies the Shoot that should be registered as Seed.

Field Description
name
string

Name is the name of the Shoot that will be registered as Seed.

UpdateStrategy

(Appears on:ManagedSeedSetSpec)

UpdateStrategy specifies the strategy that the ManagedSeedSet controller will use to perform updates. It includes any additional parameters necessary to perform the update for the indicated strategy.

Field Description
type
UpdateStrategyType
(Optional)

Type indicates the type of the UpdateStrategy. Defaults to RollingUpdate.

rollingUpdate
RollingUpdateStrategy
(Optional)

RollingUpdate is used to communicate parameters when Type is RollingUpdateStrategyType.

UpdateStrategyType

Underlying type: string

(Appears on:UpdateStrategy)

UpdateStrategyType is a string enumeration type that enumerates all possible update strategies for the ManagedSeedSet controller.