Skip to content

Commit 14bd4e5

Browse files
committed
Add deprecation notices related to matchLabelKeys/mismatchLabelKeys
1 parent 495abc8 commit 14bd4e5

File tree

1 file changed

+4
-0
lines changed

1 file changed

+4
-0
lines changed

content/en/docs/concepts/scheduling-eviction/assign-pod-node.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -377,6 +377,8 @@ when satisfying the Pod (anti)affinity.
377377
The keys are used to look up values from the pod labels; those key-value labels are combined
378378
(using `AND`) with the match restrictions defined using the `labelSelector` field. The combined
379379
filtering selects the set of existing pods that will be taken into Pod (anti)affinity calculation.
380+
It's not recommended to use `matchLabelKeys` with labels that might be updated
381+
because the update of the label isn't reflected onto the merged `LabelSelector`.
380382

381383
A common use case is to use `matchLabelKeys` with `pod-template-hash` (set on Pods
382384
managed as part of a Deployment, where the value is unique for each revision).
@@ -424,6 +426,8 @@ When you want to disable it, you have to disable it explicitly via the
424426
Kubernetes includes an optional `mismatchLabelKeys` field for Pod affinity
425427
or anti-affinity. The field specifies keys for the labels that should **not** match with the incoming Pod's labels,
426428
when satisfying the Pod (anti)affinity.
429+
It's not recommended to use `mismatchLabelKeys` with labels that might be updated
430+
because the update of the label isn't reflected onto the merged `LabelSelector`.
427431

428432
One example use case is to ensure Pods go to the topology domain (node, zone, etc) where only Pods from the same tenant or team are scheduled in.
429433
In other words, you want to avoid running Pods from two different tenants on the same topology domain at the same time.

0 commit comments

Comments
 (0)