在集群中使用级联删除

本页介绍如何在集群的级联删除期间,指定要使用的垃圾回收类型。

开始之前

你需要有一个 Kubernetes 集群,并且必须将 kubectl 命令行工具配置为与你的集群通信。 建议在至少两个不充当控制平面主机的节点上的集群中运行本教程。 如果你还没有集群,可以使用 minikube 创建一个,或者可以使用这些 Kubernetes 游乐场之一

你还需要创建一个示例 Deployment,以便试验不同类型的级联删除。 你需要为每种类型重新创建 Deployment。

检查 Pod 的所有者引用

检查你的 Pod 上是否存在 ownerReferences 字段

kubectl get pods -l app=nginx --output=yaml

输出具有类似于以下的 ownerReferences 字段

apiVersion: v1
    ...
    ownerReferences:
    - apiVersion: apps/v1
      blockOwnerDeletion: true
      controller: true
      kind: ReplicaSet
      name: nginx-deployment-6b474476c4
      uid: 4fdcd81c-bd5d-41f7-97af-3a3b759af9a7
    ...

使用前台级联删除

默认情况下,Kubernetes 使用后台级联删除来删除对象的依赖项。 你可以使用 kubectl 或 Kubernetes API 切换到前台级联删除,具体取决于你的集群运行的 Kubernetes 版本。 要检查版本,请输入 kubectl version

你可以使用 kubectl 或 Kubernetes API 使用前台级联删除来删除对象。

使用 kubectl

运行以下命令

kubectl delete deployment nginx-deployment --cascade=foreground

使用 Kubernetes API

  1. 启动本地代理会话

    kubectl proxy --port=8080
    
  2. 使用 curl 触发删除

    curl -X DELETE localhost:8080/apis/apps/v1/namespaces/default/deployments/nginx-deployment \
        -d '{"kind":"DeleteOptions","apiVersion":"v1","propagationPolicy":"Foreground"}' \
        -H "Content-Type: application/json"
    

    输出包含一个 foregroundDeletion 终结器,如下所示

    "kind": "Deployment",
    "apiVersion": "apps/v1",
    "metadata": {
        "name": "nginx-deployment",
        "namespace": "default",
        "uid": "d1ce1b02-cae8-4288-8a53-30e84d8fa505",
        "resourceVersion": "1363097",
        "creationTimestamp": "2021-07-08T20:24:37Z",
        "deletionTimestamp": "2021-07-08T20:27:39Z",
        "finalizers": [
          "foregroundDeletion"
        ]
        ...
    

使用后台级联删除

  1. 创建一个示例 Deployment.
  2. 使用 kubectl 或 Kubernetes API 删除 Deployment,具体取决于你的集群运行的 Kubernetes 版本。 要检查版本,请输入 kubectl version

你可以使用 kubectl 或 Kubernetes API 使用后台级联删除来删除对象。

Kubernetes 默认使用后台级联删除,即使你在没有 --cascade 标志或 propagationPolicy 参数的情况下运行以下命令也是如此。

使用 kubectl

运行以下命令

kubectl delete deployment nginx-deployment --cascade=background

使用 Kubernetes API

  1. 启动本地代理会话

    kubectl proxy --port=8080
    
  2. 使用 curl 触发删除

    curl -X DELETE localhost:8080/apis/apps/v1/namespaces/default/deployments/nginx-deployment \
        -d '{"kind":"DeleteOptions","apiVersion":"v1","propagationPolicy":"Background"}' \
        -H "Content-Type: application/json"
    

    输出类似于以下内容

    "kind": "Status",
    "apiVersion": "v1",
    ...
    "status": "Success",
    "details": {
        "name": "nginx-deployment",
        "group": "apps",
        "kind": "deployments",
        "uid": "cc9eefb9-2d49-4445-b1c1-d261c9396456"
    }
    

删除所有者对象并保留孤立的依赖项

默认情况下,当你告诉 Kubernetes 删除对象时,控制器也会删除依赖对象。 你可以使用 kubectl 或 Kubernetes API 使 Kubernetes 保留这些依赖项,具体取决于你的集群运行的 Kubernetes 版本。 要检查版本,请输入 kubectl version

使用 kubectl

运行以下命令

kubectl delete deployment nginx-deployment --cascade=orphan

使用 Kubernetes API

  1. 启动本地代理会话

    kubectl proxy --port=8080
    
  2. 使用 curl 触发删除

    curl -X DELETE localhost:8080/apis/apps/v1/namespaces/default/deployments/nginx-deployment \
        -d '{"kind":"DeleteOptions","apiVersion":"v1","propagationPolicy":"Orphan"}' \
        -H "Content-Type: application/json"
    

    输出在 finalizers 字段中包含 orphan,类似于以下内容

    "kind": "Deployment",
    "apiVersion": "apps/v1",
    "namespace": "default",
    "uid": "6f577034-42a0-479d-be21-78018c466f1f",
    "creationTimestamp": "2021-07-09T16:46:37Z",
    "deletionTimestamp": "2021-07-09T16:47:08Z",
    "deletionGracePeriodSeconds": 0,
    "finalizers": [
      "orphan"
    ],
    ...
    

你可以检查由 Deployment 管理的 Pod 是否仍在运行

kubectl get pods -l app=nginx

下一步

上次修改时间:2023 年 1 月 11 日下午 11:12 PST:更新 /tasks/administer-cluster 部分中的页面权重 (b1202c78ff)