Manages a Kubernetes Node Pool, part of a managed Kubernetes cluster on IonosCloud.

Example Usage

Argument Reference

The following arguments are supported:

• name - (Required)[string] The name of the Kubernetes Cluster. This attribute is immutable.

• k8s_version - (Optional)[string] The desired Kubernetes Version. for supported values, please check the API documentation. The provider will ignore changes of patch level.

• auto_scaling - (Optional)[string] Wether the Node Pool should autoscale. For more details, please check the API documentation

  • min_node_count - (Required)[int] The minimum number of worker nodes the node pool can scale down to. Should be less than max_node_count

  • max_node_count - (Required)[int] The maximum number of worker nodes that the node pool can scale to. Should be greater than min_node_count

• lans - (Optional)[list] A list of numeric LAN id's you want this node pool to be part of. For more details, please check the API documentation, as well as the example above

• maintenance_window - (Optional) See the maintenance_window section in the example above

  • time - (Required)[string] A clock time in the day when maintenance is allowed

  • day_of_the_week - (Required)[string] Day of the week when maintenance is allowed

• datacenter_id - (Required)[string] A Datacenter's UUID

• k8s_cluster_id- (Required)[string] A k8s cluster's UUID

• cpu_family - (Required)[string] The desired CPU Family - See the API documentation for more information. This attribute is immutable.

• availability_zone - (Required)[string] - The desired Compute availability zone - See the API documentation for more information. This attribute is immutable.

• storage_type -(Required)[string] - The desired storage type - SSD/HDD. This attribute is immutable.

• node_count -(Required)[int] - The desired number of nodes in the node pool

• cores_count -(Required)[int] - The CPU cores count for each node of the node pool. This attribute is immutable.

• ram_size -(Required)[int] - The desired amount of RAM, in MB. This attribute is immutable.

• storage_size -(Required)[int] - The desired amount of storage for each node, in GB. This attribute is immutable.

• public_ips - (Optional)[list] A list of public IPs associated with the node pool; must have at least node_count + 1 elements;

• labels - (Optional)[map] A key/value map of labels

• annotations - (Optional)[map] A key/value map of annotations

Import

A Kubernetes Node Pool resource can be imported using its Kubernetes cluster's uuid as well as its own UUID, both of which you can retreive from the cloud API: resource id, e.g.:

This can be helpful when you want to import kubernetes node pools which you have already created manually or using other means, outside of terraform, towards the goal of managing them via Terraform

Manages a Managed Kubernetes cluster on IonosCloud.

Example Usage

resource "ionoscloud_k8s_cluster" "example" {
  name        = "example"
  k8s_version = "1.18.5"
  maintenance_window {
    day_of_the_week = "Monday"
    time            = "09:30:00Z"
  }
}

Argument Reference

The following arguments are supported:

• name - (Required)[string] The name of the Kubernetes Cluster.

• k8s_version - (Optional)[string] The desired Kubernetes Version. For supported values, please check the API documentation. The provider will ignore changes of patch level.

• maintenance_window - (Optional) See the maintenance_window section in the example above

  • time - (Required)[string] A clock time in the day when maintenance is allowed

  • day_of_the_week - (Required)[string] Day of the week when maintenance is allowed

• viable_node_pool_versions - (Computed) List of versions that may be used for node pools under this cluster

• api_subnet_allow_list - (Optional) Access to the K8s API server is restricted to these CIDRs. Cluster-internal traffic is not affected by this restriction. If no allowlist is specified, access is not restricted. If an IP without subnet mask is provided, the default value will be used: 32 for IPv4 and 128 for IPv6.

• s3_buckets - (Optional) List of S3 bucket configured for K8s usage. For now it contains only an S3 bucket used to store K8s API audit logs.

Import

A Kubernetes Cluster resource can be imported using its resource id, e.g.

terraform import ionoscloud_k8s_cluster.demo {k8s_cluster uuid}

This can be helpful when you want to import kubernetes clusters which you have already created manually or using other means, outside of terraform.

Important Notes

• Please note that every ionoscloud_datacenter resource you plan to add kubernetes node pools for the cluster to needs to also be specified as a dependency of the Kubernetes cluster by using the depends_on meta-property (For more details, please see https://www.terraform.io/docs/configuration/resources.html#resource-dependencies). This will ensure that resources are destroyed in the right order. In case you do not do this, you might encounter problems when deleting the Virtual Datacenter. In return, this will give you the ability to keep the data in your PersistentVolumeClaims across NodePools created in the same Virtual Datacenter ionoscloud_datacenter