PRR Remarks - batching mechanism

kubernetes · Oct 2, 2023 · d0a45b3 · d0a45b3
1 parent fc9b1c8
commit d0a45b3
Showing 1 changed file with 9 additions and 2 deletions.
diff --git a/keps/sig-apps/2879-ready-pods-job-status/README.md b/keps/sig-apps/2879-ready-pods-job-status/README.md
@@ -282,8 +282,15 @@ No.
 
 - API: PUT Job/status
 
-  Estimated throughput: at most one API call for each Job Pod reaching Ready
-  condition.
+  Estimated throughput: at most one additional API call for each Job Pod reaching
+  Ready condition per second. The reason is that the update of the `.status.ready`
+  field triggers another reconciliation of the Job controller.
+
+  In order to constrain the number of reconciliations, the Job controller
+  batches and deduplicates reconciliation requests within a second.
+
+  In other words, if there is another reconciliation request planned within a
+  second, the one triggered by `.status.ready` update is skipped.
 
   Originating component: job-controller