A top-level annotation updates an existing ReplicaSet, while a template annotation creates a new Pod.

Annotations carry metadata that consumers can interpret

Annotations attach non-identifying metadata to Kubernetes objects. They can record provenance, ownership notes, or information consumed by a tool. Standard label selectors do not select objects by annotation values, but that does not make annotations inert. A controller, admission component, or deployment tool can interpret a documented annotation and change behavior accordingly. Know the consumer before deciding that a metadata edit is harmless. ...

March 10, 2027 · 6 min · XB Field Notes