Skip to content

Commit

Permalink
Review comments
Browse files Browse the repository at this point in the history
Change-Id: Ib09b350b8898bea3668e33d6cafc2022b5d3633e
  • Loading branch information
alculquicondor committed Mar 25, 2024
1 parent 3471b7f commit 8f58385
Showing 1 changed file with 15 additions and 5 deletions.
20 changes: 15 additions & 5 deletions site/content/en/docs/tasks/troubleshooting/troubleshooting_pods.md
Expand Up @@ -14,9 +14,9 @@ You can read [Troubleshooting Jobs](troubleshooting_jobs) for more general troub

## Is my Pod managed directly by Kueue?

When Kueue adds the label `kueue.x-k8s.io/managed` with value `true` to Pods that it manages.
If the label is not present, it means that Kueue is not going to admit or account for the resource usage
of this Pod directly.
Kueue adds the label `kueue.x-k8s.io/managed` with value `true` to Pods that it manages.
If the label is not present on a Pod, it means that Kueue is not going to admit or account for the
resource usage of this Pod directly.

A Pod might not have the `kueue.x-k8s.io/managed` due to one of the following reasons:

Expand Down Expand Up @@ -80,14 +80,24 @@ the standard way of terminating a Pod in Kubernetes.
When using single Pods, Kubernetes will delete Workload object along with the Pod, as there is
nothing else holding ownership to it.

## Why aren't Pods deleted when Failed or Succeeded?
Kueue doesn't typically fully delete Pods in a Pod group upon preemption. See the next question
to understand the deletion mechanics for Pods in a Pod group.

## Why aren't Pods in a Pod group deleted when Failed or Succeeded?

When using Pod groups, Kueue keeps a [finalizer](https://kubernetes.io/docs/concepts/overview/working-with-objects/finalizers/)
`kueue.x-k8s.io/managed` to prevent Pods from being deleted and to be able to track the progress of the group.
You should not modify finalizers manually.

Kueue will remove the finalizer from Pods when:
- The group satisfies the [termination](/docs/tasks/run/plain_pods/#termination) criteria.
- The group satisfies the [termination](/docs/tasks/run/plain_pods/#termination) criteria, for example,
when all Pods terminate successfully.
- For Failed Pods, when Kueue observes a replacement Pod.
- You delete the Workload object.

Once a Pod doesn't have any finalizers, Kubernetes will delete the Pods based on:
- Whether a user or a controller has issued a Pod deletion.
- The [Pod garbage collector](https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#pod-garbage-collection).

## See Also

Expand Down

0 comments on commit 8f58385

Please sign in to comment.