Skip to main content

Task Stop

Stop a running Task using an annotation. This is the recommended way to terminate a Task — prefer this over kubectl delete task.

Stopping a Task​

kubectl annotate task my-task kubeopencode.io/stop=true

When this annotation is detected:

  • The controller deletes the Pod (with graceful termination period)
  • Task status is set to Phase=Completed with a Stopped condition
  • The Stopped condition has reason UserStopped

Checking Stopped Task Status​

# Check the task phase
kubectl get task my-task -o jsonpath='{.status.phase}'
# Output: Completed

# Check the stopped condition
kubectl get task my-task -o jsonpath='{.status.conditions[?(@.type=="Stopped")]}'

Important Notes​

Logs are lost when a Task is stopped

When a Task is stopped, the underlying Pod is deleted. Pod logs are no longer accessible via kubectl logs. For log persistence, use an external log aggregation system (Fluentd, Loki, etc.).

Prefer kubectl annotate task over kubectl delete task

Using the stop annotation preserves the Task object for status inspection and auditing. Deleting the Task removes it entirely.