diff --git a/docs/concepts/workloads/controllers/garbage-collection.md b/docs/concepts/workloads/controllers/garbage-collection.md index 0672d3a479..a7d9b1491b 100644 --- a/docs/concepts/workloads/controllers/garbage-collection.md +++ b/docs/concepts/workloads/controllers/garbage-collection.md @@ -147,6 +147,13 @@ Here's an example that orphans the dependents of a ReplicaSet: kubectl delete replicaset my-repset --cascade=false ``` +### Addtional note on Deployments + +When using cascading deletes with deployments you *must* use _propagationPolicy: Foreground_ +to delete not only the ReplicaSets created, but also their Pods. If this type of _propagationPolicy_ +is not used, only the ReplicaSets will be deleted, and the Pods will be orphaned. +See [kubeadm/#149](https://github.com/kubernetes/kubeadm/issues/149#issuecomment-284766613) for more information. + ## Known issues * As of 1.7, garbage collection does not yet support [custom resources](/docs/concepts/api-extension/custom-resources/),