KubernetesCluster

class KubernetesCluster : KotlinCustomResource

Import

Before importing a Kubernetes cluster, the cluster's default node pool must be tagged with the terraform:default-node-pool tag. The provider will automatically add this tag if the cluster only has a single node pool. Clusters with more than one node pool, however, will require that you manually add the terraform:default-node-pool tag to the node pool that you intend to be the default node pool. Then the Kubernetes cluster and its default node pool can be imported using the cluster's id, e.g.

$ pulumi import digitalocean:index/kubernetesCluster:KubernetesCluster mycluster 1b8b2100-0e9f-4e8f-ad78-9eb578c2a0af

Additional node pools must be imported separately as digitalocean_kubernetes_cluster resources, e.g.

$ pulumi import digitalocean:index/kubernetesCluster:KubernetesCluster mynodepool 9d76f410-9284-4436-9633-4066852442c8

Properties

Link copied to clipboard
val autoUpgrade: Output<Boolean>?

A boolean value indicating whether the cluster will be automatically upgraded to new patch releases during its maintenance window.

Link copied to clipboard

Block containing options for cluster auto-scaling.

Link copied to clipboard
val clusterSubnet: Output<String>

The range of IP addresses in the overlay network of the Kubernetes cluster. For more information, see here.

Link copied to clipboard
val clusterUrn: Output<String>

The uniform resource name (URN) for the Kubernetes cluster.

Link copied to clipboard
val createdAt: Output<String>

The date and time when the node was created.

Link copied to clipboard

Use with caution. When set to true, all associated DigitalOcean resources created via the Kubernetes API (load balancers, volumes, and volume snapshots) will be destroyed along with the cluster when it is destroyed.

Link copied to clipboard
val endpoint: Output<String>

The base URL of the API server on the Kubernetes master node.

Link copied to clipboard
val ha: Output<Boolean>?

Enable/disable the high availability control plane for a cluster. Once enabled for a cluster, high availability cannot be disabled. Default: false

Link copied to clipboard
val id: Output<String>
Link copied to clipboard
val ipv4Address: Output<String>

The public IPv4 address of the Kubernetes master node. This will not be set if high availability is configured on the cluster (v1.21+)

Link copied to clipboard

The duration in seconds that the returned Kubernetes credentials will be valid. If not set or 0, the credentials will have a 7 day expiry.

Link copied to clipboard

A representation of the Kubernetes cluster's kubeconfig with the following attributes:

Link copied to clipboard

A block representing the cluster's maintenance window. Updates will be applied within this window. If not specified, a default maintenance window will be chosen. auto_upgrade must be set to true for this to have an effect.

Link copied to clipboard
val name: Output<String>

A name for the Kubernetes cluster.

Link copied to clipboard

A block representing the cluster's default node pool. Additional node pools may be added to the cluster using the digitalocean.KubernetesNodePool resource. The following arguments may be specified:

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
val region: Output<String>

The slug identifier for the region where the Kubernetes cluster will be created.

Link copied to clipboard

Enables or disables the DigitalOcean container registry integration for the cluster. This requires that a container registry has first been created for the account. Default: false

Link copied to clipboard

Block containing options for the routing-agent component. If not specified, the routing-agent component will not be installed in the cluster.

Link copied to clipboard
val serviceSubnet: Output<String>

The range of assignable IP addresses for services running in the Kubernetes cluster. For more information, see here.

Link copied to clipboard
val status: Output<String>

A string indicating the current status of the individual node.

Link copied to clipboard
val surgeUpgrade: Output<Boolean>?

Enable/disable surge upgrades for a cluster. Default: true

Link copied to clipboard
val tags: Output<List<String>>?

A list of tag names to be applied to the Kubernetes cluster.

Link copied to clipboard
val updatedAt: Output<String>

The date and time when the node was last updated.

Link copied to clipboard
val urn: Output<String>
Link copied to clipboard
val version: Output<String>

The slug identifier for the version of Kubernetes used for the cluster. Use doctl to find the available versions doctl kubernetes options versions. (Note: A cluster may only be upgraded to newer versions in-place. If the version is decreased, a new resource will be created.)

Link copied to clipboard
val vpcUuid: Output<String>

The ID of the VPC where the Kubernetes cluster will be located.