Skip to content

Commit

Permalink
Add the information about the managedBy field
Browse files Browse the repository at this point in the history
  • Loading branch information
mimowo committed Mar 6, 2024
1 parent 6959fc0 commit 47490b8
Show file tree
Hide file tree
Showing 2 changed files with 23 additions and 2 deletions.
21 changes: 21 additions & 0 deletions content/en/docs/concepts/workloads/controllers/job.md
Expand Up @@ -1006,6 +1006,27 @@ status:
terminating: 3 # three Pods are terminating and have not yet reached the Failed phase
```

### Delegation of managing a Job object to external controller

{{< feature-state for_k8s_version="v1.30" state="alpha" >}}

This feature allows you to disable the built-in Job controller, for a specific
Job, and delegate reconciliation of the Job to an external controller.

By setting a custom value of the `spec.managedBy` field - any value
other than `kubernetes.io/job-controller` - you indicate the controller which
reconciles the Job. The value of the field is immutable.

{{< note >}}
When using this feature make sure the controller indicated by the field is
installed, otherwise the Job may not be reconciled at all.
{{< /note >}}

{{< note >}}
When developing an external Job controller make sure it does not use the
`batch.kubernetes.io/job-tracking` finalizer, reserved for the built-in controller.
{{< /note >}}

## Alternatives

### Bare Pods
Expand Down
@@ -1,13 +1,13 @@
---
title: JobManagedByLabel
title: JobManagedBy
content_type: feature_gate

_build:
list: never
render: false

stages:
- stage: beta
- stage: alpha
defaultValue: false
fromVersion: "1.30"
---
Expand Down

0 comments on commit 47490b8

Please sign in to comment.