Skip to content

Latest commit

 

History

History
127 lines (85 loc) · 4.04 KB

kubernetes.md

File metadata and controls

127 lines (85 loc) · 4.04 KB
page_title cozystack_kubernetes Data Source - cozystack
subcategory
description Read an existing Cozystack Kubernetes cluster by name and namespace.

cozystack_kubernetes (Data Source)

Read an existing Cozystack Kubernetes cluster by name and namespace.

Example Usage

data "cozystack_kubernetes" "cluster" {
  name      = "cluster"
  namespace = "tenant-root"
}

# The platform materialises its own defaults on read, so the effective Talos
# release is reported even for a cluster that never pinned one.
output "cluster_talos_version" {
  value = data.cozystack_kubernetes.cluster.talos.version
}

output "cluster_oidc_mode" {
  value = data.cozystack_kubernetes.cluster.oidc.mode
}

Schema

Required

  • name (String) Kubernetes cluster name.
  • namespace (String) Tenant namespace.

Read-Only

  • chart_version (String) Deployed chart version.
  • control_plane (Attributes) Tenant control-plane configuration. (see below for nested schema)
  • host (String) External hostname for the cluster.
  • id (String) Synthetic identifier namespace/name.
  • images (Attributes) Image overrides for air-gapped or rate-limited registries. (see below for nested schema)
  • kubeconfig (String, Sensitive) Admin kubeconfig for the cluster.
  • oidc (Attributes) OIDC authentication and per-user RBAC for the tenant kube-apiserver. (see below for nested schema)
  • ready (Boolean) Whether the application's Ready condition is true.
  • storage_class (String) StorageClass used to store the data.
  • talos (Attributes) Talos worker OS image coordinates. (see below for nested schema)
  • uid (String) Server-assigned object UID (metadata.uid).
  • version (String) Kubernetes version.

Nested Schema for control_plane

Read-Only:

Nested Schema for control_plane.api_server

Read-Only:

  • extra_args (List of String) Extra kube-apiserver command-line flags.
  • extra_volume_mounts (List of String) Extra kube-apiserver volume mounts, as JSON documents.
  • extra_volumes (List of String) Extra control-plane volumes, as JSON documents.

Nested Schema for images

Read-Only:

  • kubectl (String) Bootstrap-token Job image.
  • talos_csr_signer (String) talos-csr-signer sidecar image.
  • wait_for_kubeconfig (String) wait-for-kubeconfig init container image.

Nested Schema for oidc

Read-Only:

  • custom_config (Attributes) Tenant-supplied AuthenticationConfiguration. (see below for nested schema)
  • mode (String) Identity mode.
  • users (Attributes List) Users granted access to the tenant cluster. (see below for nested schema)

Nested Schema for oidc.custom_config

Read-Only:

  • config (String) Inline AuthenticationConfiguration YAML.
  • secret_ref (Attributes) Secret holding the AuthenticationConfiguration. (see below for nested schema)

Nested Schema for oidc.custom_config.secret_ref

Read-Only:

  • name (String) Secret name.

Nested Schema for oidc.users

Read-Only:

  • email (String) Email claim matched for this binding.
  • role (String) Bound role.

Nested Schema for talos

Read-Only:

  • image_factory_url (String) Talos Image Factory base URL.
  • installer_repository (String) Talos installer OCI repository prefix.
  • schematic_id (String) Talos image-factory schematic ID.
  • version (String) Talos release used for workers.