Problem:
The LimitPodHardAntiAffinityTopology documentation states:
This admission controller denies any pod that defines AntiAffinity topology key other than kubernetes.io/hostname in requiredDuringSchedulingRequiredDuringExecution.
This is misleading because requiredDuringSchedulingRequiredDuringExecution was never implemented in the Kubernetes API.
The actual admission controller source code checks both requiredDuringSchedulingRequiredDuringExecution and requiredDuringSchedulingIgnoredDuringExecution, but only the latter exists in the API and affects real workloads.
Proposed Solution:
Update the description to mention both fields, matching the source code:
This admission controller denies any pod that defines AntiAffinity topology key other than kubernetes.io/hostname in requiredDuringSchedulingRequiredDuringExecution and requiredDuringSchedulingIgnoredDuringExecution.
Or, since requiredDuringSchedulingRequiredDuringExecution was never implemented, consider only referencing requiredDuringSchedulingIgnoredDuringExecution.
Page to Update:
https://kubernetes.io/docs/reference/access-authn-authz/admission-controllers/#limitpodhardantiaffinitytopology
Additional Information:
Problem:
The LimitPodHardAntiAffinityTopology documentation states:
This is misleading because
requiredDuringSchedulingRequiredDuringExecutionwas never implemented in the Kubernetes API.The actual admission controller source code checks both
requiredDuringSchedulingRequiredDuringExecutionandrequiredDuringSchedulingIgnoredDuringExecution, but only the latter exists in the API and affects real workloads.Proposed Solution:
Update the description to mention both fields, matching the source code:
Or, since
requiredDuringSchedulingRequiredDuringExecutionwas never implemented, consider only referencingrequiredDuringSchedulingIgnoredDuringExecution.Page to Update:
https://kubernetes.io/docs/reference/access-authn-authz/admission-controllers/#limitpodhardantiaffinitytopology
Additional Information:
requiredDuringSchedulingRequiredDuringExecutionwas never implemented: requiredDuringSchedulingRequiredDuringExecution status kubernetes#96149