在叢集中使用級聯刪除

本頁面展示瞭如何指定在叢集 垃圾收集 期間使用的 級聯刪除 型別。

準備工作

你需要擁有一個 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)