seedmanagement.md

Packages:

• seedmanagement.gardener.cloud/v1alpha1

seedmanagement.gardener.cloud/v1alpha1

Resource Types:

• Gardenlet
• ManagedSeed
• ManagedSeedSet
• ManagedSeedTemplate

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.