How kubernetes-sigs/descheduler works
Descheduler is a Kubernetes workload rebalancer: it evaluates already-running pods against a configurable policy and evicts eligible pods; Kubernetes’ default scheduler handles replacements. The main flow is server startup and policy setup, strategy evaluation through framework profiles and plugins, then guarded eviction through the Kubernetes API. The README also documents utilization-based strategies, Prometheus and metrics-provider inputs, and metrics exposure. Several orchestration and integration files were not sampled, so uncertain internal links are omitted or marked unverified.
Main entry points: scheme.go API scheme · evictions.go Pod eviction · server.go CLI command · profile.go Profile execution
Components 24
Startup and policy
- CLI command
cmd/descheduler/app/server.go - Server options
cmd/descheduler/app/options/options.go - Policy API
pkg/api/v1alpha2/types.go - API scheme
pkg/descheduler/scheme/scheme.go
Strategy framework
- Descheduler cycle
pkg/descheduler/descheduler.go - Profile execution
pkg/framework/profile/profile.go - Plugin registry
pkg/framework/pluginregistry/pluginregistry.go
Descheduling strategies
- Default evictor
pkg/framework/plugins/defaultevictor/defaultevictor.go - Node utilization
pkg/framework/plugins/nodeutilization/highnodeutilization.go - Usage clients
pkg/framework/plugins/nodeutilization/usageclients.go - Pod lifetime
pkg/framework/plugins/podlifetime/pod_lifetime.go - Duplicate pods
pkg/framework/plugins/removeduplicates/removeduplicates.go - Failed pods
pkg/framework/plugins/removefailedpods/failedpods.go - Topology spread
pkg/framework/plugins/removepodsviolatingtopologyspreadconstraint/topologyspreadconstraint.go - Affinity and taints
pkg/framework/plugins/removepodsviolatingnodeaffinity/node_affinity.go
Cluster operations
- Pod eviction
pkg/descheduler/evictions/evictions.go - Kubernetes clients
pkg/descheduler/client/client.go - Client sandbox
pkg/descheduler/kubeclientsandbox.go - Prometheus controller
pkg/descheduler/prom_client_controller.go - Utilization metrics
pkg/descheduler/metricscollector/metricscollector.go - Exported metrics
metrics/metrics.go
Other components
- Operator / deployment
- Kubernetes API
- Prometheus
Connections 29
- Operator / deployment → CLI command: starts
- CLI command → Server options: configures
cmd/descheduler/app/server.go - Server options → API scheme: loads scheme
cmd/descheduler/app/options/options.go - CLI command → Descheduler cycle: runs
cmd/descheduler/app/server.go - Descheduler cycle → Profile execution: dispatches cycle
- Policy API → Profile execution: configures
- Profile execution → Plugin registry: uses registry
pkg/framework/profile/profile.go - Profile execution → Pod eviction: invokes eviction
pkg/framework/profile/profile.go - API scheme → Default evictor: registers
pkg/descheduler/scheme/scheme.go - API scheme → Node utilization: registers
pkg/descheduler/scheme/scheme.go - API scheme → Pod lifetime: registers
pkg/descheduler/scheme/scheme.go - API scheme → Duplicate pods: registers
pkg/descheduler/scheme/scheme.go - API scheme → Failed pods: registers
pkg/descheduler/scheme/scheme.go - API scheme → Topology spread: registers
pkg/descheduler/scheme/scheme.go - API scheme → Affinity and taints: registers
pkg/descheduler/scheme/scheme.go - Node utilization → Usage clients: reads usage
pkg/framework/plugins/nodeutilization/usageclients.go - Usage clients → Utilization metrics: queries metrics
pkg/framework/plugins/nodeutilization/usageclients.go - Usage clients → Prometheus: queries optionally
- Prometheus controller → Kubernetes clients: creates client
pkg/descheduler/prom_client_controller.go - Kubernetes clients → Prometheus: connects
pkg/descheduler/client/client.go - Pod eviction → Kubernetes API: evicts pods
- Descheduler cycle → Kubernetes API: reads cluster
- CLI command → Exported metrics: serves metrics
cmd/descheduler/app/server.go - Pod eviction → Exported metrics: records evictions
pkg/descheduler/evictions/evictions.go - Default evictor → Pod eviction: filters pods
pkg/framework/plugins/defaultevictor/defaultevictor.go - Pod lifetime → Pod eviction: requests eviction
- Duplicate pods → Pod eviction: requests eviction
pkg/framework/plugins/removeduplicates/removeduplicates.go - Failed pods → Pod eviction: requests eviction
pkg/framework/plugins/removefailedpods/failedpods.go - Topology spread → Pod eviction: requests eviction
pkg/framework/plugins/removepodsviolatingtopologyspreadconstraint/topologyspreadconstraint.go