Merge pull request #98817 from alculquicondor/job-completion-api

Add Job.status.uncountedTerminatedPods for Job tracking

api/openapi-spec/swagger.json

@@ -3685,6 +3685,10 @@
           "description": "The number of pods which reached phase Succeeded.",
           "format": "int32",
           "type": "integer"
+        },
+        "uncountedTerminatedPods": {
+          "$ref": "#/definitions/io.k8s.api.batch.v1.UncountedTerminatedPods",
+          "description": "UncountedTerminatedPods holds the UIDs of Pods that have terminated but the job controller hasn't yet accounted for in the status counters.\n\nThe job controller creates pods with a finalizer. When a pod terminates (succeeded or failed), the controller does three steps to account for it in the job status: (1) Add the pod UID to the arrays in this field. (2) Remove the pod finalizer. (3) Remove the pod UID from the arrays while increasing the corresponding\n    counter.\n\nThis field is alpha-level. The job controller only makes use of this field when the feature gate PodTrackingWithFinalizers is enabled. Old jobs might not be tracked using this field, in which case the field remains null."
         }
       },
       "type": "object"
@@ -3703,6 +3707,28 @@
       },
       "type": "object"
     },
+    "io.k8s.api.batch.v1.UncountedTerminatedPods": {
+      "description": "UncountedTerminatedPods holds UIDs of Pods that have terminated but haven't been accounted in Job status counters.",
+      "properties": {
+        "failed": {
+          "description": "Failed holds UIDs of failed Pods.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array",
+          "x-kubernetes-list-type": "set"
+        },
+        "succeeded": {
+          "description": "Succeeded holds UIDs of succeeded Pods.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array",
+          "x-kubernetes-list-type": "set"
+        }
+      },
+      "type": "object"
+    },
     "io.k8s.api.batch.v1beta1.CronJob": {
       "description": "CronJob represents the configuration of a single cron job.",
       "properties": {