kupe_cluster

Reads an existing Kupe cluster by name.

Example Usage

data "kupe_cluster" "production" {
  name = "production"
}

Schema

Required

• name (String) Cluster name to look up.

Read-Only

• display_name (String) Human-readable cluster name.
• endpoint (String) Cluster API server endpoint.
• ha_configured (Boolean) True once the operator has confirmed both 3/3 apiserver replicas AND 3/3 deployed-etcd replicas are Ready for the first time. Etcd readiness is required because the OSS deployed-etcd path runs etcd in its own StatefulSet — quorum loss with healthy apiserver pods still blocks writes.
• ha_enabled_at (String) Timestamp when ha_configured first became true (billing anchor).
• ha_etcd_replicas_desired (Number) Target HA etcd replica count (3 when high_availability = true, 0 otherwise).
• ha_etcd_replicas_ready (Number) Count of deployed-etcd replicas currently Ready. Exposed separately because the OSS deployed-etcd path runs etcd in its own StatefulSet — quorum loss blocks writes even when the apiserver replicas are healthy.
• ha_phase (String) Consumer-friendly HA rollup. One of pending, ha-healthy, ha-degraded, ha-unavailable. Empty for non-HA clusters.
• ha_replicas_desired (Number) Target HA replica count (3 when high_availability = true, 0 otherwise).
• ha_replicas_ready (Number) Count of HA control-plane (apiserver) replicas currently Ready.
• high_availability (Boolean) Whether the cluster is configured with HA (3-replica control plane). Reflects spec, not operational state — see ha_configured.
• phase (String) Current cluster phase, for example Pending, Provisioning, Running, Upgrading, or Degraded.
• type (String) Cluster type. Today the operator only supports shared — dedicated was reserved in the CRD enum but is currently rejected with CLUSTER_DEDICATED_UNSUPPORTED.
• version (String) Current Kubernetes version for the cluster.