DisaggregatedSet API

spec defines the desired state of DisaggregatedSet

status defines the observed state of DisaggregatedSet

Name is the unique identifier for this role.

Scaling configures how replicas are determined. Omit for inline Static scaling (default). When set to External, the DisaggregatedSet controller auto-creates a DisaggregatedSetRoleScaler and reads its spec.replicas.

LeaderWorkerSetTemplateSpec defines the LWS template for this role. Note: Spec.RolloutStrategy.Type must be RollingUpdate (or empty) and Spec.RolloutStrategy.RollingUpdateConfiguration.Partition must not be set. DisaggregatedSet handles rollouts across roles.

spec defines the desired state of DisaggregatedSetRoleScaler

status defines the observed state of DisaggregatedSetRoleScaler

Replicas is the desired replica count for the role. The controller seeds this at scaler creation — 1 for a fresh role (0 would deadlock vanilla HPA in ScalingDisabled), or the LWS's current replica count for a Static→External flip so the role does not silently drain to zero. External autoscalers overwrite it on their first tick.

Non-pointer with a default because kube-apiserver's CRD /scale handler extracts .spec.replicas at read time and errors ("the spec replicas field does not exist") when the JSONPath resolves to nothing. HPA reads /scale before its first write; a missing field would deadlock the loop.

Replicas is the observed replica count for this role — LWS groups (== leader pods), aggregated across all revisions currently present. Read by HPA as the "current" count for its ratio math.

Selector is a label selector (in string form) matching one pod per LWS group (the leader), across all revisions: disaggregatedset.x-k8s.io/name=,disaggregatedset.x-k8s.io/role=,leaderworkerset.sigs.k8s.io/worker-index=0 Leader-only so HPA's per-pod-metric averaging divides by group count (matching spec.replicas that HPA writes), keeping the ratio math consistent for leaderWorkerTemplate.size > 1. Aggregate across revisions so HPA observes the serving fleet during a rolling update.

ObservedGeneration is the .metadata.generation the status reflects.

Conditions expose scaler-level state (Ready).

Roles defines the list of roles (at least 2 required). Each role has a unique name and its own configuration.

Slices is the number of independent copies of the whole role topology. Each slice is a complete set of all roles that rolls out independently. Changing Slices scales copies up or down and does not trigger a rollout.

PlacementPolicy controls how a slice's roles are co-located and how the DisaggregatedSet's slices are spread across topology domains. When set, the controller injects pod affinity and anti-affinity into the managed LeaderWorkerSet pod templates. Placement is applied when a LeaderWorkerSet is created, so changing it takes effect on the next rollout.

RoleStatuses contains the status for each role. The order matches spec.roles.

conditions represent the current state of the DisaggregatedSet resource. Each condition has a unique type and reflects the status of a specific aspect of the resource.

Standard condition types include:

• "Available": the resource is fully functional
• "Progressing": the resource is being created or updated
• "Degraded": the resource failed to reach or maintain its desired state

The status of each condition is one of True, False, or Unknown.

Type selects the placement guarantee. Defaults to None.

Topology is the node-label key that defines a domain, used as the affinity topologyKey. Required when Type is not None.

Mode controls the source of the replica count. Static (default) uses inline spec.replicas; External uses the auto-created scaler CR.

Name is the name of the role (matches spec.roles[].name).

Replicas is the total number of replicas for this role.

ReadyReplicas is the number of ready replicas for this role.

UpdatedReplicas is the number of replicas updated to the latest revision.