From 47490b873f47fd3d986014e99e7f9e94d05279c6 Mon Sep 17 00:00:00 2001
From: Michal Wozniak <michalwozniak@google.com>
Date: Thu, 15 Feb 2024 19:16:13 +0100
Subject: [PATCH] Add the information about the managedBy field

---
 .../concepts/workloads/controllers/job.md     | 21 +++++++++++++++++++
 ...-managed-by-label.md => job-managed-by.md} |  4 ++--
 2 files changed, 23 insertions(+), 2 deletions(-)
 rename content/en/docs/reference/command-line-tools-reference/feature-gates/{job-managed-by-label.md => job-managed-by.md} (83%)

diff --git a/content/en/docs/concepts/workloads/controllers/job.md b/content/en/docs/concepts/workloads/controllers/job.md
index be5775973b83d..3b59333b05200 100644
--- a/content/en/docs/concepts/workloads/controllers/job.md
+++ b/content/en/docs/concepts/workloads/controllers/job.md
@@ -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
diff --git a/content/en/docs/reference/command-line-tools-reference/feature-gates/job-managed-by-label.md b/content/en/docs/reference/command-line-tools-reference/feature-gates/job-managed-by.md
similarity index 83%
rename from content/en/docs/reference/command-line-tools-reference/feature-gates/job-managed-by-label.md
rename to content/en/docs/reference/command-line-tools-reference/feature-gates/job-managed-by.md
index ab4464356fe95..38733b6de66ff 100644
--- a/content/en/docs/reference/command-line-tools-reference/feature-gates/job-managed-by-label.md
+++ b/content/en/docs/reference/command-line-tools-reference/feature-gates/job-managed-by.md
@@ -1,5 +1,5 @@
 ---
-title: JobManagedByLabel
+title: JobManagedBy
 content_type: feature_gate
 
 _build:
@@ -7,7 +7,7 @@ _build:
   render: false
 
 stages:
-  - stage: beta
+  - stage: alpha
     defaultValue: false
     fromVersion: "1.30"
 ---