diff --git a/content/zh/docs/concepts/workloads/controllers/garbage-collection.md b/content/zh/docs/concepts/workloads/controllers/garbage-collection.md index 5bd78ed6bfb62..20cb708c15383 100644 --- a/content/zh/docs/concepts/workloads/controllers/garbage-collection.md +++ b/content/zh/docs/concepts/workloads/controllers/garbage-collection.md @@ -5,43 +5,71 @@ redirect_from: - "/docs/concepts/abstractions/controllers/garbage-collection.html" - "/docs/user-guide/garbage-collection/" - "/docs/user-guide/garbage-collection.html" +content_template: templates/concept +--- + {{% capture overview %}} + - -Kubernetes 垃圾收集器的角色是删除指定的对象,这些对象曾经有但以后不再拥有 Owner 了。 - -**注意**:垃圾收集是 beta 特性,在 Kubernetes 1.4 及以上版本默认启用。 +Kubernetes 垃圾收集器的作用是删除某些曾经拥有所有者(owner)但现在不再拥有所有者的对象。 {{% /capture %}} {{% capture body %}} + +## 所有者和附属 +某些 Kubernetes 对象是其它一些对象的所有者。例如,一个 ReplicaSet 是一组 Pod 的所有者。 +具有所有者的对象被称为是所有者的*附属*。 +每个附属对象具有一个指向其所属对象的 `metadata.ownerReferences` 字段。 -也可以通过手动设置 `ownerReference` 的值,来指定 Owner 和 Dependent 之间的关系。 +有时,Kubernetes 会自动设置 `ownerReference` 的值。 +例如,当创建一个 ReplicaSet 时,Kubernetes 自动设置 ReplicaSet 中每个 Pod 的 `ownerReference` 字段值。 +在 1.6 版本,Kubernetes 会自动为某些对象设置 `ownerReference` 的值,这些对象是由 ReplicationController、ReplicaSet、StatefulSet、DaemonSet 和 Deployment 所创建或管理。 +也可以通过手动设置 `ownerReference` 的值,来指定所有者和附属之间的关系。 这里有一个配置文件,表示一个具有 3 个 Pod 的 ReplicaSet: {{< codenew file="controllers/replicaset.yaml" >}} - + 如果创建该 ReplicaSet,然后查看 Pod 的 metadata 字段,能够看到 OwnerReferences 字段: @@ -50,9 +78,11 @@ kubectl apply -f https://k8s.io/examples/controllers/replicaset.yaml kubectl get pods --output=yaml ``` + - -输出显示了 Pod 的 Owner 是名为 my-repset 的 ReplicaSet: +输出显示了 Pod 的所有者是名为 my-repset 的 ReplicaSet: ```shell apiVersion: v1 @@ -60,7 +90,7 @@ kind: Pod metadata: ... ownerReferences: - - apiVersion: extensions/v1beta1 + - apiVersion: apps/v1 controller: true blockOwnerDeletion: true kind: ReplicaSet @@ -69,101 +99,201 @@ metadata: ... ``` +{{< note >}} + + + +设计不允许跨命名空间指定所有者。这意味着: + +1)命名空间范围的附属只能在相同的命名空间中指定所有者,并且只能指定集群范围的所有者。 + +2)集群范围的附属只能指定集群范围的所有者,不能指定命名空间范围的。 -## 控制垃圾收集器删除 Dependent +{{< /note >}} -当删除对象时,可以指定是否该对象的 Dependent 也自动删除掉。 + +## 控制垃圾收集器删除附属者 + +当删除对象时,可以指定是否该对象的附属者也自动删除掉。 自动删除 Dependent 也称为 *级联删除* 。 Kubernetes 中有两种 *级联删除* 的模式:*background* 模式和 *foreground* 模式。 -如果删除对象时,不自动删除它的 Dependent,这些 Dependent 被称作是原对象的 *孤儿* 。 +如果删除对象时,不自动删除它的附属者,这些附属者被称作是原对象的*孤儿* 。 + + -### Foreground 级联删除 +### 显式级联删除 -在 *foreground 级联删除* 模式下,根对象首先进入 “删除中” 状态。在 “删除中” 状态会有如下的情况: +在*显式级联删除*模式下,根对象首先进入 `deletion in progress` 状态。在 `deletion in progress` 状态会有如下的情况: * 对象仍然可以通过 REST API 可见。 * 会设置对象的 `deletionTimestamp` 字段。 - * 对象的 `metadata.finalizers` 字段包含了值 "foregroundDeletion"。 + * 对象的 `metadata.finalizers` 字段包含了值 `foregroundDeletion`。 - 一旦对象被设置为 “删除中” 状态,垃圾收集器会删除对象的所有 Dependent。 - 垃圾收集器在删除了所有 “Blocking” 状态的 Dependent(对象的 `ownerReference.blockOwnerDeletion=true`)之后,它会删除 Owner 对象。 +一旦对象被设置为 `deletion in progress` 状态,垃圾收集器会删除对象的所有附属。 + 垃圾收集器在删除了所有 `Blocking` 状态的附属(对象的 `ownerReference.blockOwnerDeletion=true`)之后,它会删除拥有者对象。 -注意,在 “foreground 删除” 模式下,只有设置了 `ownerReference.blockOwnerDeletion` 值的 Dependent 才能阻止删除 Owner 对象。 -在 Kubernetes 1.7 版本中将增加许可控制器(Admission Controller),基于 Owner 对象上的删除权限来控制用户去设置 `blockOwnerDeletion` 的值为 true,所以未授权的 Dependent 不能够延迟 Owner 对象的删除。 +注意,在 `foregroundDeletion` 模式下,只有设置了 `ownerReference.blockOwnerDeletion` 值的附属者才能阻止删除拥有者对象。 +在 Kubernetes 1.7 版本中将增加准入控制器(Admission Controller),基于拥有者对象上的删除权限来控制用户去设置 `blockOwnerDeletion` 的值为 true,所以未授权的附属者不能够延迟拥有者对象的删除。 如果一个对象的 `ownerReferences` 字段被一个 Controller(例如 Deployment 或 ReplicaSet)设置,`blockOwnerDeletion` 会被自动设置,不需要手动修改这个字段。 + +### 隐式级联删除 + +在 *隐式级联删除除* 模式下,Kubernetes 会立即删除拥有者对象,然后垃圾收集器会在后台删除这些附属。 + + ### 设置级联删除策略 -通过为 Owner 对象设置 `deleteOptions.propagationPolicy` 字段,可以控制级联删除策略。 -可能的取值包括:“orphan”、“Foreground” 或 “Background”。 +通过为拥有者对象设置 `deleteOptions.propagationPolicy` 字段,可以控制级联删除策略。 +可能的取值包括:`orphan`、`Foreground`或`Background`。 对很多 Controller 资源,包括 ReplicationController、ReplicaSet、StatefulSet、DaemonSet 和 Deployment,默认的垃圾收集策略是 `orphan`。 -因此,除非指定其它的垃圾收集策略,否则所有 Dependent 对象使用的都是 `orphan` 策略。 +因此,除非指定其它的垃圾收集策略,否则所有附属对象使用的都是 `orphan` 策略。 下面是一个在后台删除 Dependent 对象的例子: ```shell kubectl proxy --port=8080 -curl -X DELETE localhost:8080/apis/extensions/v1beta1/namespaces/default/replicasets/my-repset \ --d '{"kind":"DeleteOptions","apiVersion":"v1","propagationPolicy":"Background"}' \ --H "Content-Type: application/json" +curl -X DELETE localhost:8080/apis/apps/v1/namespaces/default/replicasets/my-repset \ + -d '{"kind":"DeleteOptions","apiVersion":"v1","propagationPolicy":"Background"}' \ + -H "Content-Type: application/json" ``` + - -下面是一个在前台删除 Dependent 对象的例子: +下面是一个在前台删除附属对象的例子: ```shell kubectl proxy --port=8080 -curl -X DELETE localhost:8080/apis/extensions/v1beta1/namespaces/default/replicasets/my-repset \ --d '{"kind":"DeleteOptions","apiVersion":"v1","propagationPolicy":"Foreground"}' \ --H "Content-Type: application/json" +curl -X DELETE localhost:8080/apis/apps/v1/namespaces/default/replicasets/my-repset \ + -d '{"kind":"DeleteOptions","apiVersion":"v1","propagationPolicy":"Foreground"}' \ + -H "Content-Type: application/json" ``` + -下面是一个孤儿 Dependent 的例子: +这里是一个孤儿附属的例子: ```shell kubectl proxy --port=8080 -curl -X DELETE localhost:8080/apis/extensions/v1beta1/namespaces/default/replicasets/my-repset \ --d '{"kind":"DeleteOptions","apiVersion":"v1","propagationPolicy":"Orphan"}' \ --H "Content-Type: application/json" +curl -X DELETE localhost:8080/apis/apps/v1/namespaces/default/replicasets/my-repset \ + -d '{"kind":"DeleteOptions","apiVersion":"v1","propagationPolicy":"Orphan"}' \ + -H "Content-Type: application/json" ``` + kubectl 也支持级联删除。 -通过设置 `--cascade` 为 true,可以使用 kubectl 自动删除 Dependent 对象。 -设置 `--cascade` 为 false,会使 Dependent 对象成为孤儿 Dependent 对象。 -`--cascade` 的默认值是 true。 - -下面是一个例子,使一个 ReplicaSet 的 Dependent 对象成为孤儿 Dependent: +通过设置 `--cascade` 为 `true`,可以使用 kubectl 自动删除附属对象。设置 `--cascade` 为 `false`,会使附属对象成为孤儿附属对象。`--cascade` 的默认值是 true。 +下面是一个例子,使一个 ReplicaSet 的附属对象成为孤儿附属: ```shell kubectl delete replicaset my-repset --cascade=false ``` + + +### Deployment 的其他说明 + +在 1.7 之前的版本中,当在 Deployment 中使用级联删除时,您必须*使用* `propagationPolicy:Foreground`。不仅删除创建的 ReplicaSet,还删除其 Pod。如果不使用这种类型的 `propagationPolicy`,则将只删除 ReplicaSet,而 Pod 被孤立。 + +更多信息,请参考 [kubeadm/#149](https://github.com/kubernetes/kubeadm/issues/149#issuecomment-284766613)。 + + ## 已知的问题 -* 1.7 版本,垃圾收集不支持 [自定义资源](/docs/concepts/api-extension/custom-resources/),比如那些通过 CustomResourceDefinition 新增,或者通过 API server 聚集而成的资源对象。 -[其它已知的问题](https://github.com/kubernetes/kubernetes/issues/26120) +跟踪 [#26120](https://github.com/kubernetes/kubernetes/issues/26120) {{% /capture %}} @@ -171,9 +301,10 @@ kubectl delete replicaset my-repset --cascade=false {{% capture whatsnext %}} +## 控制垃圾收集器删除附属者 +[设计文档 1](https://git.k8s.io/community/contributors/design-proposals/api-machinery/garbage-collection.md) -[设计文档 1](https://git.k8s.io/community/contributors/design-proposals/garbage-collection.md) -[设计文档 2](https://git.k8s.io/community/contributors/design-proposals/synchronous-garbage-collection.md) +[设计文档 2](https://git.k8s.io/community/contributors/design-proposals/api-machinery/synchronous-garbage-collection.md) {{% /capture %}}