Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Manage additional Kubernetes node pools with Terraform — node count, autoscaling bounds, labels and taints.
raff_k8s_cluster (default_pool). Each pool has its own plan_id, so pools in one cluster can use different plans and tiers.
Scale-down drains nodes first, honouring PodDisruptionBudgets — a node that can’t be emptied stops the operation. On a subscription cluster, growing a pool via Terraform charges the pro-rated difference to the saved payment method and raises the monthly price.
resource "raff_k8s_node_pool" "batch" {
cluster_id = raff_k8s_cluster.prod.cluster_id
name = "batch"
plan_id = data.raff_k8s_node_plans.all.plans[0].id
node_count = 2
autoscale_enabled = true
min_nodes = 2
max_nodes = 6
labels = jsonencode({ workload = "batch" })
taints = jsonencode([{ key = "batch", value = "true", effect = "NoSchedule" }])
}
| Argument | Type | Required? | Description |
|---|---|---|---|
cluster_id | string | Yes | Short cluster ID (raff_k8s_cluster.x.cluster_id) |
name | string | Yes | Pool name, unique in the cluster |
plan_id | int | Yes | Worker node plan ID for this pool — pools may use different plans |
node_count | int | Yes | Node count (1–20; the cluster keeps ≥2 workers overall) |
autoscale_enabled | bool | No | Enable autoscaling between min_nodes and max_nodes |
min_nodes | int | No | Autoscale lower bound |
max_nodes | int | No | Autoscale upper bound |
labels | string | No | JSON object of Kubernetes labels applied to every node, e.g. {"tier":"db"} |
taints | string | No | JSON array of taints, e.g. [{"key":"gpu","value":"true","effect":"NoSchedule"}] |
| Attribute | Description |
|---|---|
id | Pool ID |
actual_node_count | Nodes that currently exist — differs from node_count briefly while scaling, and when the autoscaler has added nodes above the base |
terraform import raff_k8s_node_pool.batch <cluster-id>/<pool-id>