Kubernetes YAML Cheat Sheet/Spread replicas across nodes

Avoid colocating the same app on one node.

Section: Scheduling and Placement

Spread replicas across nodes

yaml
yaml
affinity:
  podAntiAffinity:
    preferredDuringSchedulingIgnoredDuringExecution:
      - weight: 100
        podAffinityTerm:
          labelSelector:
            matchLabels:
              app: api
          topologyKey: kubernetes.io/hostname

Learn the surrounding workflow

Compare similar commands or jump into common fixes when this command is part of a bigger troubleshooting path.

Related commands

Same sheet · prioritizing Scheduling and Placement
Use required node affinity
More expressive scheduling constraints.
OpenIn sheetyamlsame section
Schedule onto labeled nodes
Require a simple node label match.
OpenIn sheetyamlsame section
Tolerate tainted nodes
Allow pods onto special-purpose nodes.
OpenIn sheetyamlsame section
Minimal Pod manifest
Smallest practical Pod YAML shape.
Labels and annotations example
Common metadata block for selectors and tooling.
Override container command and args
Set entrypoint-style command in YAML.