terraform-provider-stackitprivatepreview/docs/data-sources/ske_cluster.md

page_title	subcategory	description
stackit_ske_cluster Data Source - stackit		SKE Cluster data source schema. Must have a region specified in the provider configuration.

stackit_ske_cluster (Data Source)

SKE Cluster data source schema. Must have a region specified in the provider configuration.

Example Usage

data "stackit_ske_cluster" "example" {
  project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  name       = "example-name"
}

Schema

Required

• name (String) The cluster name.
• project_id (String) STACKIT project ID to which the cluster is associated.

Optional

• region (String) The resource region. If not defined, the provider region is used.

Read-Only

• allow_privileged_containers (Boolean, Deprecated) DEPRECATED as of Kubernetes 1.25+ Flag to specify if privileged mode for containers is enabled or not. This should be used with care since it also disables a couple of other features like the use of some volume type (e.g. PVCs).
• egress_address_ranges (List of String) The outgoing network ranges (in CIDR notation) of traffic originating from workload on the cluster.
• extensions (Attributes) A single extensions block as defined below (see below for nested schema)
• hibernations (Attributes List) One or more hibernation block as defined below. (see below for nested schema)
• id (String) Terraform's internal data source. ID. It is structured as "project_id,name".
• kubernetes_version (String, Deprecated) Kubernetes version. This field is deprecated, use kubernetes_version_used instead
• kubernetes_version_min (String) The minimum Kubernetes version, this field is always nil. SKE automatically updates the cluster Kubernetes version if you have set maintenance.enable_kubernetes_version_updates to true or if there is a mandatory update, as described in Updates for Kubernetes versions and Operating System versions in SKE. To get the current kubernetes version being used for your cluster, use the kubernetes_version_used field.
• kubernetes_version_used (String) Full Kubernetes version used. For example, if 1.22 was selected, this value may result to 1.22.15
• maintenance (Attributes) A single maintenance block as defined below (see below for nested schema)
• network (Attributes) Network block as defined below. (see below for nested schema)
• node_pools (Attributes List) One or more node_pool block as defined below. (see below for nested schema)
• pod_address_ranges (List of String) The network ranges (in CIDR notation) used by pods of the cluster.

Nested Schema for extensions

Read-Only:

• acl (Attributes) Cluster access control configuration (see below for nested schema)
• argus (Attributes) A single argus block as defined below (see below for nested schema)
• dns (Attributes) DNS extension configuration (see below for nested schema)

Nested Schema for extensions.acl

Read-Only:

• allowed_cidrs (List of String) Specify a list of CIDRs to whitelist
• enabled (Boolean) Is ACL enabled?

Nested Schema for extensions.argus

Read-Only:

• argus_instance_id (String) Instance ID of argus
• enabled (Boolean) Flag to enable/disable argus extensions.

Nested Schema for extensions.dns

Read-Only:

• enabled (Boolean) Flag to enable/disable DNS extensions
• zones (List of String) Specify a list of domain filters for externalDNS (e.g., foo.runs.onstackit.cloud)

Nested Schema for hibernations

Read-Only:

• end (String) End time of hibernation, in crontab syntax.
• start (String) Start time of cluster hibernation in crontab syntax.
• timezone (String) Timezone name corresponding to a file in the IANA Time Zone database.

Nested Schema for maintenance

Read-Only:

• enable_kubernetes_version_updates (Boolean) Flag to enable/disable auto-updates of the Kubernetes version.
• enable_machine_image_version_updates (Boolean) Flag to enable/disable auto-updates of the OS image version.
• end (String) Date time for maintenance window end.
• start (String) Date time for maintenance window start.

Nested Schema for network

Read-Only:

• id (String) ID of the STACKIT Network Area (SNA) network into which the cluster will be deployed.

Nested Schema for node_pools

Read-Only:

• allow_system_components (Boolean) Allow system components to run on this node pool.
• availability_zones (List of String) Specify a list of availability zones.
• cri (String) Specifies the container runtime.
• labels (Map of String) Labels to add to each node.
• machine_type (String) The machine type.
• max_surge (Number) The maximum number of nodes upgraded simultaneously.
• max_unavailable (Number) The maximum number of nodes unavailable during upgraded.
• maximum (Number) Maximum number of nodes in the pool.
• minimum (Number) Minimum number of nodes in the pool.
• name (String) Specifies the name of the node pool.
• os_name (String) The name of the OS image.
• os_version (String) The OS image version.
• os_version_min (String) The minimum OS image version, this field is always nil. SKE automatically updates the cluster Kubernetes version if you have set maintenance.enable_kubernetes_version_updates to true or if there is a mandatory update, as described in Updates for Kubernetes versions and Operating System versions in SKE. To get the current OS image version being used for the node pool, use the read-only os_version_used field.
• os_version_used (String) Full OS image version used. For example, if 3815.2 was set in os_version_min, this value may result to 3815.2.2. SKE automatically updates the cluster Kubernetes version if you have set maintenance.enable_kubernetes_version_updates to true or if there is a mandatory update, as described in Updates for Kubernetes versions and Operating System versions in SKE.
• taints (Attributes List) Specifies a taint list as defined below. (see below for nested schema)
• volume_size (Number) The volume size in GB.
• volume_type (String) Specifies the volume type.

Nested Schema for node_pools.taints

Read-Only:

• effect (String) The taint effect.
• key (String) Taint key to be applied to a node.
• value (String) Taint value corresponding to the taint key.