From c15a08afd17ee12c0fecc008ae9325f9fafa774b Mon Sep 17 00:00:00 2001 From: Ajay <217481+ajaygm@users.noreply.github.com> Date: Thu, 7 Jan 2021 07:45:11 +0530 Subject: [PATCH 1/3] Fixed deprecated delete cascade 'false' value `kubectl delete --cascade=false` is now deprecated in favor of `kubectl delete --cascade=orphan` --- content/en/docs/concepts/workloads/controllers/replicaset.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/concepts/workloads/controllers/replicaset.md b/content/en/docs/concepts/workloads/controllers/replicaset.md index ba0270b573..e45d20c8f7 100644 --- a/content/en/docs/concepts/workloads/controllers/replicaset.md +++ b/content/en/docs/concepts/workloads/controllers/replicaset.md @@ -283,7 +283,7 @@ curl -X DELETE 'localhost:8080/apis/apps/v1/namespaces/default/replicasets/fron ### Deleting just a ReplicaSet -You can delete a ReplicaSet without affecting any of its Pods using [`kubectl delete`](/docs/reference/generated/kubectl/kubectl-commands#delete) with the `--cascade=false` option. +You can delete a ReplicaSet without affecting any of its Pods using [`kubectl delete`](/docs/reference/generated/kubectl/kubectl-commands#delete) with the `--cascade=orphan` option. When using the REST API or the `client-go` library, you must set `propagationPolicy` to `Orphan`. For example: ```shell From 0be35d69dd927a283ec7444a3df1a502bab6f228 Mon Sep 17 00:00:00 2001 From: Ajay <217481+ajaygm@users.noreply.github.com> Date: Fri, 8 Jan 2021 07:37:03 +0530 Subject: [PATCH 2/3] Update garbage-collection.md --- .../workloads/controllers/garbage-collection.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/content/en/docs/concepts/workloads/controllers/garbage-collection.md b/content/en/docs/concepts/workloads/controllers/garbage-collection.md index 0e9b4f746a..aaf9cd08ac 100644 --- a/content/en/docs/concepts/workloads/controllers/garbage-collection.md +++ b/content/en/docs/concepts/workloads/controllers/garbage-collection.md @@ -150,14 +150,16 @@ curl -X DELETE localhost:8080/apis/apps/v1/namespaces/default/replicasets/my-rep ``` kubectl also supports cascading deletion. -To delete dependents automatically using kubectl, set `--cascade` to true. To -orphan dependents, set `--cascade` to false. The default value for `--cascade` -is true. + +To delete dependents in the foreground using kubectl, set `--cascade=foreground`. To +orphan dependents, set `--cascade=orphan`. + +The default behavior is to delete dependents in the background i.e. no `--cascade` option or `--cascade=background`. Here's an example that orphans the dependents of a ReplicaSet: ```shell -kubectl delete replicaset my-repset --cascade=false +kubectl delete replicaset my-repset --cascade=orphan ``` ### Additional note on Deployments From 27ceb5928adbbed93ab545931d568777a001537f Mon Sep 17 00:00:00 2001 From: Ajay <217481+ajaygm@users.noreply.github.com> Date: Fri, 8 Jan 2021 11:48:48 +0530 Subject: [PATCH 3/3] rephrased as suggested by tengqm Co-authored-by: Qiming Teng --- .../docs/concepts/workloads/controllers/garbage-collection.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/content/en/docs/concepts/workloads/controllers/garbage-collection.md b/content/en/docs/concepts/workloads/controllers/garbage-collection.md index aaf9cd08ac..1b1de5d0a4 100644 --- a/content/en/docs/concepts/workloads/controllers/garbage-collection.md +++ b/content/en/docs/concepts/workloads/controllers/garbage-collection.md @@ -154,7 +154,8 @@ kubectl also supports cascading deletion. To delete dependents in the foreground using kubectl, set `--cascade=foreground`. To orphan dependents, set `--cascade=orphan`. -The default behavior is to delete dependents in the background i.e. no `--cascade` option or `--cascade=background`. +The default behavior is to delete the dependents in the background which is the +behavior when `--cascade` is omitted or explicitly set to `background`. Here's an example that orphans the dependents of a ReplicaSet: