KRM API cluster.gdc.goog/v1

cluster.gdc.goog/v1

Contains API Schema definitions for the Cluster group.

Channel

Underlying type: string Indicates a specific type of release channel.

Cluster

Specifies a GDCH user cluster.

Field	Description
`apiVersion` string	`cluster.gdc.goog/v1`
`kind` string	`Cluster`
`metadata` ObjectMeta	Refer to Kubernetes API documentation for fields of `metadata`.
`spec` ClusterSpec
`status` ClusterStatus

ClusterList

Represents a collection of clusters.

Field	Description
`apiVersion` string	`cluster.gdc.goog/v1`
`kind` string	`ClusterList`
`metadata` ListMeta	Refer to Kubernetes API documentation for fields of `metadata`.
`items` Cluster array

ClusterNetwork

Specifies the cluster network configuration.

Appears in: - ClusterSpec

Field	Description
`podCIDRSize` integer	The size of network ranges from which pod virtual IP addresses are allocated. If unset, a default value `21` is used.
`serviceCIDRSize` integer	The size of network ranges from which service virtual IP addresses are allocated. If unset, a default value `23` is used.

ClusterSpec

Appears in: - Cluster

Field	Description
`initialVersion` ClusterVersion	The GDCH version information of the user cluster during cluster creation. Optional. Default to use the latest applicable version. Immutable.
`releaseChannel` ReleaseChannel	The release channel a cluster is subscribed to. When a cluster is subscribed to a release channel, GDCH maintains the cluster versions for users. Optional. Mutable.
`clusterNetwork` ClusterNetwork	The cluster network configuration. If unset, the default configurations with pod and service CIDR sizes are used. Optional. Mutable.
`loadBalancer` LoadBalancer	The load balancer configuration. If unset, the default configuration with the ingress service IP address size is used. Optional. Mutable.
`nodePools` NodePool array	The list of node pools for the cluster worker nodes. Optional. Mutable.

ClusterState

Underlying type: string Indicates the state of the cluster.

Appears in: - ClusterStatus

ClusterStatus

Defines the observed state of the cluster.

Appears in: - Cluster

Field	Description
`conditions` Condition array	The latest observations of the cluster state. Conditions such as `Reconciling` and `Stalled` indicate whether the last cluster reconciliation succeeded.
`errorStatus` ErrorStatus	The observed error status of the cluster.
`workerNodePoolStatuses` NodePoolStatus array	A list of observed statuses of the worker node pools.
`controlPlaneConditions` Condition array	Whether the control plane is ready.
`componentsConditions` Condition array	Whether the GDCH user cluster components have successfully deployed.
`versionStatus` VersionStatus	The installed version information of the cluster.
`clusterState` ClusterState	The state of the cluster. The following states are available: `Running`: the cluster has been created and is usable. `Reconciling`: some work is actively being done on the cluster. `Deleting`: the cluster is being deleted. `Error`: some errors occurred while reconciling/provisioning the cluster.

ClusterVersion

Specifies the version information of a GDCH user cluster.

Appears in: - ClusterSpec

Field	Description
`kubernetesVersion` string	The Kubernetes version of the GDCH user cluster.

LoadBalancer

Specifies the load balancer configuration.

Appears in: - ClusterSpec

Field	Description
`ingressServiceIPSize` integer	The size of non-overlapping IP pools used by the load balancer typed services. If unset, a default value `20` is used.

NodePool

Specifies the NodePool custom resource configuration.

Appears in: - ClusterSpec

Field	Description
`name` string	The name of the node pool.
`nodeCount` integer	The desired number of nodes in the provisioned node pool.
`machineTypeName` string	The name of the machine types that are used to provision nodes.
`taints` Taint array	The taints assigned to the nodes of this node pool.
`labels` object (keys:string, values:string)	The labels assigned to nodes of this node pool. It contains a list of key/value pairs.

NodePoolStatus

Defines the observed state of a NodePool resource.

Appears in: - ClusterStatus

Field	Description
`name` string	The name of the node pool.
`conditions` Condition array	The latest observations of the node pool's state.
`readyNodes` integer	The number of nodes that are ready to serve.
`reconcilingNodes` integer	The number of nodes that are reconciling.
`stalledNodes` integer	The number of nodes that are stalled.
`unknownNodes` integer	The number of nodes whose statuses are unknown.
`readyTimestamp` Time	The time a node pool is in `ready` status. This value will never change once it's set.
`kubernetesVersion` string	The version of Kubernetes running on this node pool's nodes.

ReleaseChannel

Indicates which release channel a cluster is subscribed to.

Appears in: - ClusterSpec

Field	Description
`channel` Channel	If unset, defaults to be `UNSPECIFIED`.

UserClusterUpgradeRequest

UserClusterUpgradeRequest represents the configuration of a user cluster upgrade request, such as the cluster reference and the target k8s version.

Appears in: - UserClusterUpgradeRequestList

Field	Description
`apiVersion` string	`cluster.gdc.goog/v1`
`kind` string	`UserClusterUpgradeRequest`
`metadata` ObjectMeta	Refer to Kubernetes API documentation for fields of `metadata`.
`spec` UserClusterUpgradeRequestSpec
`status` UserClusterUpgradeRequestStatus

UserClusterUpgradeRequestList

UserClusterUpgradeRequest represents a collection of UserClusterUpgradeRequests.

Field	Description
`apiVersion` string	`cluster.gdc.goog/v1`
`kind` string	`UserClusterUpgradeRequestList`
`metadata` ListMeta	Refer to Kubernetes API documentation for fields of `metadata`.
`items` UserClusterUpgradeRequest array

UserClusterUpgradeRequestSpec

UserClusterUpgradeRequestSpec provides the specification (i.e., desired state) of a UserClusterUpgradeRequest.

Appears in: - UserClusterUpgradeRequest

Field	Description
`clusterRef` LocalObjectReference	ClusterRef contains a reference to the GDCH user cluster object, to which the upgrade applies.
`targetVersion` string	TargetVersion has the target k8s user cluster version.

UserClusterUpgradeRequestStatus

Appears in: - UserClusterUpgradeRequest

Field	Description
`conditions` Condition array	Conditions represents the observations of the current upgrade state. Known condition types: Succeeded.
`startTime` Time	StartTime represents the observed start time for the current upgrade.

VersionStatus

Defines the installed version information of the cluster.

Appears in: - ClusterStatus

Field	Description
`componentVersion` string	The component version of the cluster.
`kubernetesVersion` string	The Kubernetes version of the cluster.