feat(ske): add datasource to query provider options

Signed-off-by: Mauritz Uphoff <mauritz.uphoff@stackit.cloud>

Author: h3adex

docs/data-sources/ske_provider_options.md

@@ -0,0 +1,101 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "stackit_ske_provider_options Data Source - stackit"
+subcategory: ""
+description: |-
+  Returns a list of supported Kubernetes versions and a list of supported machine types for the cluster nodes.
+---
+
+# stackit_ske_provider_options (Data Source)
+
+Returns a list of supported Kubernetes versions and a list of supported machine types for the cluster nodes.
+
+## Example Usage
+
+```terraform
+data "stackit_ske_provider_options" "default" {}
+
+data "stackit_ske_provider_options" "eu02" {
+  region = "eu02"
+}
+
+locals {
+  k8s_versions = [
+    for v in data.stackit_ske_provider_options.default.kubernetes_versions :
+    v.version if v.state == "supported"
+  ]
+  first_k8s_version = length(local.k8s_versions) > 0 ? local.k8s_versions[0] : ""
+  last_k8s_version  = length(local.k8s_versions) > 0 ? local.k8s_versions[length(local.k8s_versions) - 1] : ""
+
+
+  flatcar_supported_versions = flatten([
+    for mi in data.stackit_ske_provider_options.default.machine_images : [
+      for v in mi.versions :
+      v.version if mi.name == "flatcar" && v.state == "supported"
+    ]
+  ])
+
+  ubuntu_supported_versions = flatten([
+    for mi in data.stackit_ske_provider_options.default.machine_images : [
+      for v in mi.versions :
+      v.version if mi.name == "ubuntu" && v.state == "supported"
+    ]
+  ])
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Optional
+
+- `region` (String) Region override. If omitted, the provider’s region will be used.
+
+### Read-Only
+
+- `availability_zones` (List of String) List of availability zones in the selected region.
+- `kubernetes_versions` (Attributes List) Supported Kubernetes versions. (see [below for nested schema](#nestedatt--kubernetes_versions))
+- `machine_images` (Attributes List) Supported machine image types and software versions. (see [below for nested schema](#nestedatt--machine_images))
+- `machine_types` (Attributes List) List of machine types (node sizes) available in the region. (see [below for nested schema](#nestedatt--machine_types))
+- `volume_types` (List of String) Supported root volume types (e.g., `storage_premium_perf1`).
+
+<a id="nestedatt--kubernetes_versions"></a>
+### Nested Schema for `kubernetes_versions`
+
+Read-Only:
+
+- `expiration_date` (String) Expiration date of the version in RFC3339 format.
+- `state` (String) Version state, such as `supported`, `preview`, or `deprecated`.
+- `version` (String) Kubernetes version string (e.g., `1.27`).
+
+
+<a id="nestedatt--machine_images"></a>
+### Nested Schema for `machine_images`
+
+Read-Only:
+
+- `name` (String) Name of the OS image (e.g., `ubuntu`).
+- `versions` (Attributes List) Supported versions of the image. (see [below for nested schema](#nestedatt--machine_images--versions))
+
+<a id="nestedatt--machine_images--versions"></a>
+### Nested Schema for `machine_images.versions`
+
+Read-Only:
+
+- `cri` (List of String) Container runtimes supported (e.g., `containerd`).
+- `expiration_date` (String) Expiration date of the version in RFC3339 format.
+- `state` (String) State of the image version (e.g., `supported`, `preview`, `deprecated`).
+- `version` (String) Machine image version string.
+
+
+
+<a id="nestedatt--machine_types"></a>
+### Nested Schema for `machine_types`
+
+Read-Only:
+
+- `architecture` (String) CPU architecture (e.g., `x86_64`, `arm64`).
+- `cpu` (Number) Number of virtual CPUs.
+- `gpu` (Number) Number of GPUs included.
+- `memory` (Number) Memory size in GB.
+- `name` (String) Machine type name (e.g., `c2i.2`).

examples/data-sources/stackit_ske_provider_options/data-source.tf

@@ -0,0 +1,29 @@
+data "stackit_ske_provider_options" "default" {}
+
+data "stackit_ske_provider_options" "eu02" {
+  region = "eu02"
+}
+
+locals {
+  k8s_versions = [
+    for v in data.stackit_ske_provider_options.default.kubernetes_versions :
+    v.version if v.state == "supported"
+  ]
+  first_k8s_version = length(local.k8s_versions) > 0 ? local.k8s_versions[0] : ""
+  last_k8s_version  = length(local.k8s_versions) > 0 ? local.k8s_versions[length(local.k8s_versions) - 1] : ""
+
+
+  flatcar_supported_versions = flatten([
+    for mi in data.stackit_ske_provider_options.default.machine_images : [
+      for v in mi.versions :
+      v.version if mi.name == "flatcar" && v.state == "supported"
+    ]
+  ])
+
+  ubuntu_supported_versions = flatten([
+    for mi in data.stackit_ske_provider_options.default.machine_images : [
+      for v in mi.versions :
+      v.version if mi.name == "ubuntu" && v.state == "supported"
+    ]
+  ])
+}