kubectl delete

概要

通过文件名、标准输入、资源和名称，或通过资源和标签选择器来删除资源。

接受 JSON 和 YAML 格式。只允许指定一种类型的参数：文件名、资源和名称，或资源和标签选择器。

某些资源（如 Pod）支持优雅删除。这些资源定义了在强制终止前的默认时间段（优雅终止宽限期），但你可以使用 --grace-period 标志覆盖该值，或传递 --now 将宽限期设置为 1。由于这些资源通常表示集群中的实体，删除可能不会立即得到确认。如果托管 Pod 的节点宕机或无法连接 API 服务器，终止可能需要比宽限期长得多的时间。要强制删除资源，你必须指定 --force 标志。注意：只有一部分资源支持优雅删除。在不支持的情况下，--grace-period 标志将被忽略。

**重要提示：** 强制删除 Pod 不会等待 Pod 进程已终止的确认，这可能导致这些进程持续运行，直到节点检测到删除并完成优雅终止。如果你的进程使用共享存储或与远程 API 通信，并依赖 Pod 的名称来标识自己，强制删除这些 Pod 可能导致不同机器上的多个进程使用相同的标识，从而可能导致数据损坏或不一致。只有当你确定 Pod 已终止，或者你的应用程序能够容忍同一 Pod 的多个副本同时运行时，才强制删除 Pod。此外，如果你强制删除 Pod，调度器可能会在节点释放这些资源之前将新的 Pod 调度到这些节点上，从而导致这些 Pod 立即被逐出。

注意，delete 命令不执行资源版本检查，所以如果在你提交删除时有人提交了对资源的更新，他们的更新将与资源的其他部分一起丢失。

CustomResourceDefinition 删除后，发现缓存的失效可能需要长达 6 小时。如果你不想等待，可以运行 "kubectl api-resources" 来刷新发现缓存。

kubectl delete ([-f FILENAME] | [-k DIRECTORY] | TYPE [(NAME | -l label | --all)])

示例

  # Delete a pod using the type and name specified in pod.json
  kubectl delete -f ./pod.json
  
  # Delete resources from a directory containing kustomization.yaml - e.g. dir/kustomization.yaml
  kubectl delete -k dir
  
  # Delete resources from all files that end with '.json'
  kubectl delete -f '*.json'
  
  # Delete a pod based on the type and name in the JSON passed into stdin
  cat pod.json | kubectl delete -f -
  
  # Delete pods and services with same names "baz" and "foo"
  kubectl delete pod,service baz foo
  
  # Delete pods and services with label name=myLabel
  kubectl delete pods,services -l name=myLabel
  
  # Delete a pod with minimal delay
  kubectl delete pod foo --now
  
  # Force delete a pod on a dead node
  kubectl delete pod foo --force
  
  # Delete all pods
  kubectl delete pods --all
  
  # Delete all pods only if the user confirms the deletion
  kubectl delete pods --all --interactive

选项

--all

删除指定资源类型在命名空间中的所有资源。

-A, --all-namespaces

如果存在，列出所有命名空间中请求的对象。即使通过 --namespace 指定了当前上下文中的命名空间，也会被忽略。

--cascade string[="background"]     默认值: "background"

必须是 "background", "orphan", 或 "foreground" 之一。选择对依赖对象（例如 ReplicationController 创建的 Pod）的级联删除策略。默认为 background。

--dry-run string[="unchanged"]     默认值: "none"

必须是 "none", "server", 或 "client" 之一。如果是 client 策略，只打印将要发送的对象，而不实际发送。如果是 server 策略，提交服务器端请求但不持久化资源。

--field-selector string

用于过滤的选择器（字段查询），支持 '=', '==', 和 '!='。(例如：--field-selector key1=value1,key2=value2)。服务器只支持每种类型有限数量的字段查询。

-f, --filename strings

包含要删除的资源。

--force

如果为 true，立即从 API 中移除资源并跳过优雅删除。请注意，立即删除某些资源可能导致不一致或数据丢失，并且需要确认。

--grace-period int     默认值: -1

给予资源优雅终止的时间段（秒）。如果为负数则忽略。设置为 1 表示立即关闭。只有当 --force 为 true 时才能设置为 0（强制删除）。

-h, --help

delete 命令的帮助信息

--ignore-not-found

将 "资源未找到" 视为删除成功。当指定 --all 时，默认为 "true"。

-i, --interactive

如果为 true，仅在用户确认后删除资源。

-k, --kustomize string

处理 Kustomization 目录。此标志不能与 -f 或 -R 一起使用。

--now

如果为 true，向资源发送立即关闭信号（与 --grace-period=1 相同）。

-o, --output string

输出模式。使用 "-o name" 可获得更短的输出（resource/name）。

--raw string

发送 DELETE 请求到服务器的原始 URI。使用 kubeconfig 文件指定的传输方式。

-R, --recursive

递归处理在 -f, --filename 中使用的目录。当你想管理组织在同一目录中的相关 manifest 时很有用。

-l, --selector string

用于过滤的选择器（标签查询），支持 '=', '==', '!=', 'in', 'notin'。(例如：-l key1=value1,key2=value2,key3 in (value3))。匹配的对象必须满足所有指定的标签约束。

--timeout duration

删除操作放弃等待的时间长度，零表示根据对象的大小确定超时时间。

--wait     默认值: true

如果为 true，则等待资源消失后再返回。这将等待终结器 (finalizers) 完成。

继承的父选项

--as string

用于此操作的模拟用户名。用户可以是普通用户，也可以是命名空间中的 ServiceAccount。

--as-group strings

用于此操作的模拟用户组，此标志可以重复以指定多个组。

--as-uid string

用于此操作的模拟 UID。

--cache-dir string     默认值: "$HOME/.kube/cache"

默认缓存目录。

--certificate-authority string

证书颁发机构的证书文件路径。

--client-certificate string

用于 TLS 的客户端证书文件路径。

--client-key string

用于 TLS 的客户端私钥文件路径。

--cluster string

要使用的 kubeconfig 集群名称。

--context string

要使用的 kubeconfig 上下文名称。

--default-not-ready-toleration-seconds int     默认值: 300

表示默认添加到每个尚无此容忍度的 Pod 的 notReady:NoExecute 容忍度的 tolerationSeconds。

--default-unreachable-toleration-seconds int     默认值: 300

表示默认添加到每个尚无此容忍度的 Pod 的 unreachable:NoExecute 容忍度的 tolerationSeconds。

--disable-compression

如果为 true，则拒绝服务器对所有请求进行响应压缩。

--insecure-skip-tls-verify

如果为 true，将不检查服务器证书的有效性。这将使你的 HTTPS 连接不安全。

--kubeconfig string

用于 CLI 请求的 kubeconfig 文件路径。

--match-server-version

要求服务器版本与客户端版本匹配。

-n, --namespace string

如果存在，指定此 CLI 请求的命名空间范围。

--password string

用于向 API 服务器进行基本认证的密码。

--profile string     默认值: "none"

要捕获的 Profile 名称。选项包括 (none|cpu|heap|goroutine|threadcreate|block|mutex)。

--profile-output string     默认值: "profile.pprof"

写入 Profile 文件的名称。

--request-timeout string     默认值: "0"

等待单个服务器请求完成的时间长度。非零值应包含相应的时间单位（例如 1s, 2m, 3h）。零值表示请求不超时。

-s, --server string

Kubernetes API 服务器的地址和端口。

--storage-driver-buffer-duration duration     默认值: 1m0s

存储驱动器中的写入操作将缓冲此时间，然后作为一个事务提交到非内存后端。

--storage-driver-db string     默认值: "cadvisor"

数据库名称。

--storage-driver-host string     默认值: "localhost:8086"

数据库主机:端口。

--storage-driver-password string     默认值: "root"

数据库密码。

--storage-driver-secure

与数据库使用安全连接。

--storage-driver-table string     默认值: "stats"

表名。

--storage-driver-user string     默认值: "root"

数据库用户名。

--tls-server-name string

用于服务器证书验证的服务器名称。如果未提供，则使用联系服务器时使用的主机名。

--token string

用于向 API 服务器进行身份验证的 Bearer token。

--user string

要使用的 kubeconfig 用户名。

--username string

用于向 API 服务器进行基本认证的用户名。

--version version[=true]

--version, --version=raw 打印版本信息后退出；--version=vX.Y.Z... 设置报告的版本。

--warnings-as-errors

将从服务器接收到的警告视为错误并以非零退出码退出。

参见

  • kubectl - kubectl 控制 Kubernetes 集群管理器

本页面是自动生成的。

如果你计划报告此页面的问题，请在问题描述中提及此页面是自动生成的。修复可能需要在 Kubernetes 项目的其他地方进行。

上次修改于 2025 年 4 月 24 日 8:03 AM PST: kubectl reference for v1.33 (80481646c3)