FederatedCluster
federation.llmkube.dev / v1alpha1
apiVersion: federation.llmkube.dev/v1alpha1
kind: FederatedCluster
metadata:
name: example
apiVersion
string
APIVersion defines the versioned schema of this representation of an object.
Servers should convert recognized schemas to the latest internal value, and
may reject unrecognized values.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
kind
string
Kind is a string value representing the REST resource this object represents.
Servers may infer this from the endpoint the client submits requests to.
Cannot be updated.
In CamelCase.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
metadata
object
spec object
FederatedClusterSpec is admin-owned. displayName and dataResidencyTier are
set at registration; the edge and the datacenter controller only write status.
dataResidencyTier
string
DataResidencyTier is recorded now and enforced later by the federation
router (#1237). It is a free-form tier label (for example "eu", "floor-3").
displayName
string
DisplayName is a human label for the site.
heartbeatIntervalSeconds
integer
HeartbeatIntervalSeconds is how often the edge is expected to push status.
The datacenter derives staleness thresholds from it (3x Stale, 10x Unreachable).
format:
int32minimum:
5status object
FederatedClusterStatus has two writers. The edge writes everything except
Phase, over an RBAC-scoped status-subresource client. The datacenter
controller writes ONLY Phase, from LastHeartbeatTime staleness.
capacity object
Capacity is edge-owned node/GPU capacity.
gpusAllocatable
integer required
format:
int32
gpusTotal
integer required
format:
int32
nodes
integer required
format:
int32inference object
Inference is edge-owned inference health.
models
integer required
format:
int32
servicesFailed
integer required
format:
int32
servicesReady
integer required
format:
int32
servicesTotal
integer required
format:
int32
lastHeartbeatTime
string
LastHeartbeatTime is edge-owned: set to now on every successful push.
format:
date-time
observedVersion
string
ObservedVersion is edge-owned: the LLMKube/operator version on the site.
phase
string
Phase is datacenter-owned: Connected, Stale, or Unreachable.
No matches. Try .spec.dataResidencyTier for an exact path