容器与云原生 / 知识点
kubectl 日常运维命令速查
发布、扩缩容与等待
kubectl rollout restart RESOURCE在不改镜像标签的情况下触发工作负载重新滚动创建 Pod,适合刷新挂载配置或恢复异常实例;会产生实际发布变更。
滚动重启工作负载
当 Deployment、DaemonSet 或 StatefulSet 需要在不修改镜像标签的情况下重新创建 Pod 时使用。该命令会触发一次新的 rollout;执行后应继续观察发布状态,而不是把命令返回成功等同于所有新 Pod 已就绪。
基本语法
kubectl rollout restart RESOURCERESOURCE 通常写成 TYPE/NAME,例如 deployment/web。也可以结合 -n <namespace> 指定命名空间;使用标签选择器或只指定资源类型时可能同时重启多个工作负载,应先确认影响范围。
常用示例
kubectl rollout restart deployment/web
kubectl rollout status deployment/web预期输出:资源存在、更新被接受且新一轮发布最终成功时,输出类似:
deployment.apps/web restarted
deployment "web" successfully rolled out实际资源前缀和状态文本可能随 kubectl 版本略有差异;判断重点是命令退出状态以及 rollout status 是否确认发布完成。
风险与恢复
滚动重启会真实替换 Pod,瞬时可用容量受副本数、更新策略、就绪探针、PodDisruptionBudget 和集群剩余资源影响。它不会回退数据库、外部配置或其他系统状态。
如果 rollout 长时间不能完成,先检查新 Pod 的 Pending、CrashLoopBackOff、探针失败或调度错误,再修复根因。若问题来自工作负载模板的错误修订,应核对历史 revision 后再决定是否执行 kubectl rollout undo。
kubectl rollout undo (TYPE NAME | TYPE/NAME) [flags]把支持 rollout 的工作负载回退到上一修订或指定 revision,适合异常发布止损;执行前应核对历史版本和数据兼容性。
回滚上一版本
当最新一次 rollout 导致实例无法启动、健康检查失败或业务行为异常,并且历史 revision 中存在可恢复版本时使用。回滚会修改工作负载模板并再次触发发布,因此执行前必须确认目标 revision 以及应用、数据库和外部依赖的兼容性。
基本语法
kubectl rollout undo (TYPE NAME | TYPE/NAME) [flags]不指定 --to-revision 时回退到上一 revision;使用 --to-revision=<ID> 可以选择明确的历史版本。--dry-run=server 可让 API Server 校验请求但不持久化修改,适合在实际回滚前检查请求是否可接受。
执行与验证
先读取历史 revision,再执行回滚并等待新的 rollout 完成:
kubectl rollout history deployment/web
kubectl rollout undo deployment/web
kubectl rollout status deployment/web预期结果:第一条命令列出当前可用的 revision;回滚请求成功后会报告资源已 rolled back,随后状态命令在发布成功时确认 rollout 完成。典型输出形态如下,其中 revision 编号以集群实际值为准:
deployment.apps/web
REVISION CHANGE-CAUSE
<ID> <none>
<ID> <none>
deployment.apps/web rolled back
deployment "web" successfully rolled out风险与恢复
历史 revision 是否仍可用受工作负载类型及其历史保留配置影响,被清理的 revision 无法直接恢复。rollout undo 只处理 Kubernetes 工作负载的发布修订,不会自动撤销数据库迁移、消息格式、外部 Secret 或其他系统中的不兼容变更。
如果回滚到了错误版本,应重新查看 kubectl rollout history,确认正确 revision 后使用 kubectl rollout undo deployment/web --to-revision=<ID> 定向恢复,并再次检查 rollout 状态和业务健康指标。
kubectl scale [--resource-version=version] [--current-replicas=count] --replicas=COUNT (-f FILENAME | TYPE NAME)直接修改 Deployment、ReplicaSet、ReplicationController 或 StatefulSet 的副本数,适合临时扩缩容;自动伸缩场景需确认不会与 HPA 冲突。
调整副本数量
需要临时把 Deployment、ReplicaSet、ReplicationController 或 StatefulSet 调整到指定副本数时使用。命令修改的是期望副本数;控制器会随后创建或删除 Pod,因此命令成功不等于新副本已经全部就绪。
基本语法
kubectl scale [--resource-version=version] [--current-replicas=count] --replicas=COUNT (-f FILENAME | TYPE NAME)--replicas=COUNT:必填,设置目标副本数。--current-replicas=count:把当前副本数作为前置条件;实际值不匹配时不执行缩放,适合避免基于过期状态误操作。--resource-version=version:要求资源版本匹配后再修改,可用于降低并发变更覆盖风险。-f FILENAME与TYPE NAME:分别按清单文件或资源类型加名称选择目标。
常用示例
把 deployment/web 的期望副本数调整为 3,并立即读取 spec.replicas 验证写入结果:
kubectl scale deployment/web --replicas=3
kubectl get deployment/web -o jsonpath='{.spec.replicas}{"\n"}'预期输出:
deployment.apps/web scaled
3第二行只证明期望副本数已经写成 3;实际可用 Pod 可能仍在启动。若后续流程要求“全部可用”,应再等待相应就绪条件,而不是把 scale 的成功当作就绪信号。
风险与恢复
手工缩放会直接改写副本目标。资源若受 HPA 管理,HPA 后续可能再次调整副本数,因此临时扩缩容前应先确认自动伸缩策略是否会覆盖手工值。
执行前记录原副本数;需要回退时再次运行同一命令,把 --replicas 改回原值。若多人并行操作,可配合 --current-replicas 或 --resource-version 增加前置检查,避免用旧状态覆盖新变更。
kubectl wait ([-f FILENAME] | resource.group/resource.name | resource.group [(-l label | --all)]) [--for=create|--for=delete|--for condition=available|--for=jsonpath='{}'[=value]]阻塞直到资源创建、删除、状态条件或 JSONPath 值达到预期,适合脚本和发布流水线做明确检查点,并应设置超时。
等待资源条件满足
需要让脚本或发布流水线停在明确检查点,直到资源创建、删除、Condition 成立或 JSONPath 值达到预期时使用。应显式设置超时,让条件长期不满足时以失败退出,而不是无限等待。
基本语法
kubectl wait ([-f FILENAME] | resource.group/resource.name | resource.group [(-l label | --all)]) [--for=create|--for=delete|--for condition=available|--for=jsonpath='{}'[=value]]--for=create:等待目标资源出现。--for=delete:等待目标资源被删除。--for=condition=<TYPE>:等待资源的指定 Condition 达到满足状态;例如 Deployment 的Available。--for=jsonpath='{...}'[=value]:读取 JSONPath 表达式,并等待结果满足要求。--timeout=<DURATION>:限制最长等待时间,流水线中应明确设置。-f FILENAME、资源名、-l或--all:决定等待的目标范围。
常用示例
等待 deployment/web 的 Available Condition 满足,最长等待 2 分钟;成功后再读取该 Condition 的状态:
kubectl wait --for=condition=Available deployment/web --timeout=2m
kubectl get deployment/web -o jsonpath='{.status.conditions[?(@.type=="Available")].status}{"\n"}'预期输出:
deployment.apps/web condition met
True如果 2 分钟内条件没有满足,kubectl wait 会以失败状态退出;具体错误文本可能随客户端版本和资源状态不同,不应在脚本里依赖错误文案做判断。
边界与失败处理
kubectl wait 只观察条件,不会修复资源。超时后应检查资源当前状态、相关 Condition 和事件,再处理镜像拉取、调度、探针或控制器等实际故障,然后重新执行等待命令。
等待删除时,目标是否已经不存在;等待创建时,资源名或选择器是否正确;使用 JSONPath 时,先确认表达式能取到预期字段。对自动化流程,优先依据命令退出码判定成功或失败,并始终设置合理的 --timeout。
日志与交互排障
kubectl logs [-f] [-p] (POD | TYPE/NAME) [-c CONTAINER]读取 Pod 或控制器关联容器日志,可跟随输出、限定容器和截取尾部内容;适合应用错误、启动失败和请求异常的第一轮定位。
读取容器日志
应用报错、启动异常或请求失败时,先用 kubectl logs 读取容器写到标准输出和标准错误的日志。既可以针对单个 Pod,也可以从 Deployment 等资源定位其关联 Pod;读取操作不会修改工作负载。
基本语法
kubectl logs [-f] [-p] (POD | TYPE/NAME) [-c CONTAINER]-c <CONTAINER>:多容器 Pod 中指定容器;未指定时只有在容器选择不存在歧义时才能直接读取。-f:持续跟随新增日志,适合复现请求时实时观察;按Ctrl+C停止本地跟随,不影响容器。--tail=<N>:只读取末尾 N 行,避免一次拉取过多历史日志。--since=<DURATION>:只看最近一段时间,例如--since=10m。--timestamps=true:在日志行前显示时间戳,便于与事件和监控时间对齐。--all-pods=true:使用TYPE/NAME查询控制器时读取其关联的全部 Pod,而不是只取一个 Pod。
常用示例
前提是当前命名空间存在名为 web 的 Deployment。读取其关联 Pod 的末尾最多 200 行日志:
kubectl logs deployment/web --all-pods=true --tail=200预期结果:命令成功时输出 deployment/web 关联 Pod 的容器日志,具体文本和行数由应用实际产生的日志决定;没有足够日志时返回少于 200 行。若资源不存在、容器选择存在歧义或当前身份没有读取权限,命令会返回对应错误而不是修改资源。
排障边界
kubectl logs 只能读取容器运行时当前仍可提供的日志,不等同于集中式日志系统的长期历史记录。多容器 Pod 应显式使用 -c,否则可能无法确定目标容器;需要查看已经终止的上一次容器实例时改用 -p。
kubectl logs [-f] [-p] (POD | TYPE/NAME) [-c CONTAINER]通过 -p 读取同一容器上一次终止实例的日志,特别适合 CrashLoopBackOff 场景,避免重启后当前日志掩盖真实崩溃原因。
读取上一次容器日志
Pod 中的容器发生重启后,当前实例的日志可能只有新的启动信息。此时用 kubectl logs -p 读取同一容器上一次终止实例留下的日志,常用于定位 CrashLoopBackOff、异常退出和启动阶段崩溃。
基本语法
kubectl logs -p POD [-c CONTAINER]-p、--previous:读取指定容器上一次已终止实例的日志,而不是当前运行实例。-c <CONTAINER>:多容器 Pod 中指定要检查的容器;排查重启时应与发生重启的容器名称一致。--tail=<N>:限制为末尾 N 行,优先查看崩溃前最后一段输出。--timestamps=true:显示日志时间戳,便于与容器退出时间和 Kubernetes 事件对齐。
常用示例
下面假设当前命名空间存在单容器 Pod web-0,读取其上一次容器实例的末尾最多 200 行日志:
kubectl logs web-0 -p --tail=200预期结果:如果 web-0 的容器确实发生过重启且上一实例日志仍可读取,终端会输出该终止实例的最后最多 200 行日志;具体错误栈和文本由应用决定。它不会返回当前实例新产生的日志。
多容器与失败情况
如果 Pod 有多个容器,应追加 -c <CONTAINER>,否则可能因为目标容器不明确而读取失败。-p 也不保证永久保留历史:容器从未重启、上一实例日志已经不可用或 Pod 已被整体删除重建时,都可能没有可读取的 previous 日志。
CrashLoopBackOff 排查时,应优先在 Pod 尚未被替换前读取 -p;若没有 previous 日志,再结合当前日志、容器终止状态和 Pod 事件确认退出原因。
kubectl exec (POD | TYPE/NAME) [-c CONTAINER] [flags] -- COMMAND [args...]在运行中的容器里执行命令或打开交互 shell,适合检查进程、文件、网络和环境变量;生产容器内修改应保持最小化。
进入容器执行命令
需要直接读取运行中容器的进程、文件、网络状态或环境变量时使用 kubectl exec。它在现有容器中启动指定命令,不会创建新的调试容器;若镜像包含 shell,也可以建立交互会话。
基本语法
kubectl exec (POD | TYPE/NAME) [-c CONTAINER] [flags] -- COMMAND [args...]-- 用于分隔 kubectl 自身参数与容器内执行的命令,建议始终保留。多容器 Pod 应显式使用 -c CONTAINER 指定目标容器,避免进入错误的容器。
关键选项
-c, --container:指定 Pod 中的容器名称,多容器排障时尤其重要。-i, --stdin:把标准输入传给容器内进程,交互程序通常需要它。-t, --tty:分配伪终端,通常与-i一起用于 shell 会话。
如果只需执行一次检查命令,不需要 -it;自动化脚本中也应优先采用非交互命令,以便稳定读取退出码和标准输出。
可验证示例
下面在 web-0 的默认目标容器中执行一条不会修改业务状态的命令。前提是该镜像提供 sh。
kubectl exec web-0 -- sh -c 'printf "exec-ok\n"'预期输出:
exec-ok需要打开交互 shell 时,可使用元数据中的 kubectl exec -it web-0 -- sh。成功后终端会连接到容器内 shell;具体提示符由镜像和用户环境决定,因此不应依赖固定提示符文本。
风险与恢复
exec 直接运行在业务容器上下文中。不要把临时排障变成持久修改:手工编辑配置、安装软件或删除文件可能立即影响正在处理流量的进程,而且容器重建后这些修改通常不会保留。
如果命令返回“容器不存在”,先确认 Pod 实际包含的容器并使用 -c 指定;如果出现权限拒绝,需要检查当前身份对 Pod exec 子资源的授权。业务镜像没有 sh、bash 或诊断工具时,不要强行在容器内安装工具,应改用 kubectl debug 创建独立调试环境。
kubectl debug (POD | TYPE[[.VERSION].GROUP]/NAME) [ -- COMMAND [args...] ]为 Pod 或节点创建调试容器或副本,适合业务镜像缺少 shell、网络工具或系统工具时排障;需关注安全策略和权限边界。
创建临时调试会话
业务镜像没有 shell、网络工具或系统命令,或者不希望直接改动原容器时使用 kubectl debug。它可以围绕目标工作负载建立临时调试环境;本条重点使用 --copy-to 创建一个独立的 Pod 副本进行检查。
基本语法
kubectl debug (POD | TYPE[[.VERSION].GROUP]/NAME) [ -- COMMAND [args...] ]调试方式会随目标资源和所用选项变化。对 Pod 使用 --copy-to 时,会创建新的调试 Pod,而不是把原 Pod 本身改名或替换掉。
关键选项
--image:指定用于调试的容器镜像,应选择包含所需诊断工具且来源可信的镜像。--copy-to:指定新建调试 Pod 的名称,适合希望保留原 Pod 不动的排障场景。-i, --stdin:保持标准输入打开。-t, --tty:分配伪终端;与-i一起使用时适合交互调试。
业务镜像极度精简时,使用独立调试镜像通常比在原容器中临时安装工具更容易恢复,也更便于区分诊断操作与业务状态。
可验证示例
下面基于 web-0 创建名为 web-debug 的调试副本,让 BusyBox 调试容器执行 true,随后确认新 Pod 对象已经存在。
kubectl debug web-0 --copy-to=web-debug --image=busybox:1.36 -- true
kubectl get pod web-debug -o name预期结果:kubectl debug 的提示文本可能随 kubectl 版本变化,但验证命令应能读取到新建 Pod:
pod/web-debug需要交互 shell 时,可使用元数据中的 kubectl debug web-0 -it --copy-to=web-debug --image=busybox:1.36;实际进入何种默认命令取决于调试镜像,因此生产排障时最好明确所需命令和工具。
风险与恢复
创建调试 Pod 需要相应的 Kubernetes API 权限,也可能被准入控制或集群安全策略拒绝。调试镜像本身拥有额外工具,应按生产软件同样管理来源和版本,不要使用来源不明的镜像处理敏感环境。
调试副本不是业务修复方案。检查完成后确认不再需要该对象,再删除 web-debug;如果创建失败,优先查看 API 返回的权限、策略或镜像拉取错误,而不是修改原业务 Pod 来绕过限制。对于涉及标签、网络策略或服务路由的排障,还应先核对调试副本的实际配置,避免把副本误当成与原 Pod 完全相同的运行环境。
kubectl port-forward TYPE/NAME [options] [LOCAL_PORT:]REMOTE_PORT [...[LOCAL_PORT_N:]REMOTE_PORT_N]把本机端口临时转发到 Pod 或由 Service、Deployment 选择的 Pod,适合验证集群内服务;会话在目标 Pod 终止后结束。
转发本地端口
需要从本机临时访问只在集群内暴露的应用时使用 kubectl port-forward。它建立持续运行的 TCP 转发会话,不要求先创建 NodePort、LoadBalancer 或 Ingress,适合调试、接口验证和短时运维访问。
基本语法
kubectl port-forward TYPE/NAME [options] [LOCAL_PORT:]REMOTE_PORT [...[LOCAL_PORT_N:]REMOTE_PORT_N]TYPE/NAME:目标资源,例如pod/web-0、service/web或deployment/web。对 Service、Deployment 等资源执行时,kubectl 会选择对应 Pod 建立转发。LOCAL_PORT:本机监听端口;省略本地端口时可由 kubectl 选择可用端口。REMOTE_PORT:目标 Pod 中实际接收连接的端口。-n、--namespace:目标资源不在当前命名空间时指定命名空间。--address:控制本机监听地址。默认面向本机访问;显式绑定0.0.0.0会扩大可访问范围,应确认本机网络和防火墙边界。
常用示例
把本机 8080 转发到 service/web 对应 Pod 的 80 端口:
kubectl port-forward service/web 8080:80预期输出类似:
Forwarding from 127.0.0.1:8080 -> 80如果本机同时启用 IPv6,还可能看到对应的 ::1 监听信息。命令保持前台运行即表示转发会话仍在工作;此时从本机访问 127.0.0.1:8080,请求会被送到目标 Pod 的 80 端口。应用实际返回内容由目标服务决定。
会话行为
端口转发依赖当前 kubectl 进程和被选中的 Pod,不是持久化的 Kubernetes 网络配置。终端退出、命令被中断、网络连接断开,或被选中的 Pod 终止后,会话都会结束;Pod 被重新创建后通常需要重新执行命令。
kubectl port-forward 用于 TCP 端口转发,不应把它当作长期服务暴露方案。需要稳定对外提供服务时,应改用与部署环境匹配的 Service、Ingress、Gateway 或负载均衡方案。
风险与恢复
默认只在本机使用最安全。若通过 --address=0.0.0.0 等方式监听非回环地址,同网段或其他可达主机可能访问该转发端口,从而绕过原本只面向集群内部的访问边界。
需要停止时直接终止前台 kubectl port-forward 进程即可,不会修改 Service、Deployment 或 Pod 配置;如果目标选错,停止命令后以正确的资源、命名空间和端口重新执行。
权限与节点维护
kubectl auth can-i VERB [TYPE | TYPE/NAME | NONRESOURCEURL]检查当前身份或被模拟身份是否允许执行某个 API 动作,适合排查 RBAC 拒绝、验证最小权限和发布前权限预检。
检查操作权限
在执行实际变更前确认某个身份是否有权调用 Kubernetes API 时使用 kubectl auth can-i。它适合定位 Forbidden、核对命名空间权限以及做发布前最小权限预检,不会执行被检查的 get、create、delete 等目标动作。
基本语法
kubectl auth can-i VERB [TYPE | TYPE/NAME | NONRESOURCEURL]VERB:要检查的 API 动作,例如get、list、watch、create、update、patch或delete。TYPE:资源类型,例如pods、deployments。TYPE/NAME:检查针对特定资源名称的授权结果。NONRESOURCEURL:检查非资源 URL 的访问权限时使用对应路径。-n、--namespace:检查命名空间级资源时必须与实际操作所在命名空间一致。--as:按指定用户名模拟授权检查;调用者本身必须具有相应的 impersonation 权限。--as-group:与模拟用户一起指定组,可重复使用;同样受 impersonation 权限约束。
常用示例
检查当前身份能否读取 default 命名空间中的 Pod:
kubectl auth can-i get pods -n default允许时预期输出:
yes不允许时输出:
no因此脚本或人工检查应读取最终的 yes 或 no,而不是根据当前用户名称猜测权限。若命令本身返回 Forbidden 等错误,则说明授权检查请求没有正常完成,需要先处理凭据、API Server 访问或模拟身份权限问题。
判断结果时注意范围
授权通常与动词、资源、API 作用域和命名空间共同相关。default 中得到 yes,不代表在其他命名空间也具有相同权限;检查真实操作前应使用与目标请求一致的命名空间和资源类型。
can-i 回答的是授权层是否允许请求,不保证后续真实操作一定成功。资源不存在、请求参数无效、准入策略拒绝、配额限制或其他服务端校验仍可能让实际 API 请求失败。
模拟身份与安全边界
使用 --as 或 --as-group 可以验证其他身份的权限,但这不是任意切换身份的客户端功能。API Server 会先检查当前调用者是否被允许 impersonate 指定用户或组;没有该权限时,检查本身就可能被拒绝。
排查权限问题时优先检查与失败请求完全一致的 VERB、资源和命名空间。确认结果为 no 后再调整 Role、ClusterRole 或绑定关系;不要为了消除单个拒绝而直接扩大到不必要的集群级权限。
kubectl delete ([-f FILENAME] | [-k DIRECTORY] | TYPE [(NAME | -l label | --all)])按清单、资源名或选择器删除对象;生产环境应优先确认作用域与级联行为,强制删除 Pod 可能造成并发实例或数据一致性风险。
删除资源
需要按资源名、清单文件或标签批量移除 Kubernetes 对象时使用。删除前先确认当前 context、命名空间和实际匹配对象;对象删除后通常不能直接“撤销”,恢复依赖原始清单、GitOps 配置或备份。
基本语法
kubectl delete ([-f FILENAME] | [-k DIRECTORY] | TYPE [(NAME | -l label | --all)])-f FILENAME:删除清单文件中声明的对象,可指定文件、目录或 URL 等受当前 kubectl 版本支持的输入。-k DIRECTORY:根据指定 Kustomize 目录生成资源集合并删除。TYPE NAME:精确删除一个或多个指定类型、名称的资源。-l label:删除与标签选择器匹配的资源,执行前应先用相同选择器查询匹配范围。--all:删除指定资源类型在当前作用域内的全部对象,不表示删除集群中的所有资源。-n/--namespace:显式指定命名空间,避免因当前 context 的默认命名空间不同而误删。
可验证示例
下面在临时命名空间中创建并删除一个 ConfigMap,适合在有相应权限的测试集群验证命令行为。
kubectl create namespace demo-delete-check
kubectl create configmap old-config --from-literal=key=value -n demo-delete-check
kubectl delete configmap old-config -n demo-delete-check
kubectl get configmap old-config -n demo-delete-check
kubectl delete namespace demo-delete-check预期输出:第三条命令确认对象已删除,随后查询返回 NotFound;不同 kubectl 版本的错误前缀可能略有差异。
namespace/demo-delete-check created
configmap/old-config created
configmap "old-config" deleted
Error from server (NotFound): configmaps "old-config" not found
namespace "demo-delete-check" deleted批量删除前的检查
使用 -l 或 --all 时,先把删除条件原样用于 kubectl get,确认返回的名称、命名空间和数量符合预期。尤其不要在未显式确认命名空间时对生产资源执行 --all。
删除具有 ownerReferences 的对象还可能触发关联对象的级联删除;需要保留依赖对象时,应先确认该资源关系以及当前 Kubernetes 版本支持的 --cascade 策略,再决定是否使用 orphan 行为。
风险与恢复
误删普通声明式资源时,优先从经过版本控制的原始 YAML、Helm、Kustomize 或 GitOps 来源重新应用。对包含持久化数据的资源,重新创建对象并不等于数据已经恢复,应另外确认 PersistentVolume、外部数据库或备份状态。
kubectl cordon NODE把节点标记为不可调度,阻止新的普通 Pod 被调度上来,但不会驱逐现有 Pod;适合维护前先冻结节点新增负载。
禁止节点接收新 Pod
准备升级、重启或检查节点,但暂时不希望新的普通 Pod 被调度到该节点时使用 kubectl cordon。命令只改变节点的可调度状态,不会自动停止或迁移已经运行的 Pod。
基本语法
kubectl cordon NODENODE 是目标 Node 的名称。成功后节点的 spec.unschedulable 会被设为 true,Kubernetes 调度器据此避免把新的普通 Pod 调度到该节点。
常用示例
kubectl cordon worker-1
kubectl get node worker-1 -o go-template='{{.spec.unschedulable}}{{"\n"}}'预期输出:第一行表示节点已被 cordon,第二行验证不可调度标记为 true。
node/worker-1 cordoned
true如果节点此前已经处于 cordon 状态,kubectl 可能提示它已经被 cordon,而不是重复修改状态。
作用边界
cordon 不会驱逐节点上现有的 Deployment、StatefulSet 或其他工作负载 Pod,因此仅执行这一命令通常不足以完成停机维护。需要迁移现有工作负载时,应另外评估并执行 kubectl drain,同时考虑 PodDisruptionBudget、本地存储以及 DaemonSet 等约束。
此外,cordon 主要约束经过调度器放置的新 Pod;直接通过 spec.nodeName 绑定节点的 Pod 不依赖正常调度流程,不能把 cordon 当作节点级的强制隔离机制。
恢复调度
维护完成且节点健康后,使用 kubectl uncordon 恢复调度,并再次读取节点字段确认状态。
kubectl uncordon worker-1
kubectl get node worker-1 -o go-template='{{.spec.unschedulable}}{{"\n"}}'预期输出:节点恢复可调度,字段值为 false。
node/worker-1 uncordoned
falsekubectl drain NODE将节点设为不可调度并驱逐可驱逐的 Pod,适合升级、维修或下线节点;执行前需检查 PDB、DaemonSet 与 emptyDir 数据。
安全排空节点
计划升级、维修或下线节点时使用 kubectl drain。它会先把节点标记为不可调度,再尝试驱逐可驱逐的 Pod;执行前应确认 PDB、DaemonSet、无控制器 Pod 与本地 emptyDir 数据,避免把维护操作变成业务中断。
操作前检查
先确认目标节点上的工作负载以及集群中的 PodDisruptionBudget:
kubectl get node worker-1
kubectl get pod -A --field-selector spec.nodeName=worker-1 -o wide
kubectl get pdb -A预期结果:能够看到 worker-1、当前驻留 Pod 和 PDB 状态。若关键 PDB 的允许中断数为 0,或发现不能安全迁移的本地数据,应先处理这些约束再排空。
基本语法
kubectl drain NODE常用且会改变结果或风险的选项:
--ignore-daemonsets:忽略由 DaemonSet 管理的 Pod;存在 DaemonSet Pod 时通常需要此选项。--timeout=<TIME>:限制排空等待时间,避免无限等待驱逐完成。--delete-emptydir-data:允许删除使用emptyDir的 Pod,其本地临时数据会丢失。--force:允许删除没有控制器管理的 Pod,可能导致工作负载无法自动重建,应谨慎使用。
推荐执行
没有确认可以丢弃 emptyDir 数据前,不要主动加入 --delete-emptydir-data:
kubectl drain worker-1 --ignore-daemonsets --timeout=10m预期结果:节点被标记为不可调度,可安全驱逐的 Pod 被逐步迁出。如果 PDB、emptyDir、无控制器 Pod 或其他约束阻止排空,命令会失败并报告原因;此时节点仍可能已经处于不可调度状态。
风险与恢复
不要为了让命令通过而直接叠加 --force 或 --delete-emptydir-data。前者可能删除无法自动重建的 Pod,后者会丢弃 emptyDir 中的数据。
如果决定中止维护并恢复新 Pod 调度,可执行:
kubectl uncordon worker-1预期结果:worker-1 恢复为可调度状态。该操作不会自动把已经迁出的 Pod 移回原节点,应用仍应按自身健康检查验证。
kubectl uncordon NODE把维护完成的节点重新标记为可调度,使调度器能够再次放置新 Pod;通常与 cordon、drain 组合形成节点维护闭环。
恢复节点调度
节点维护完成并确认 kubelet、网络、存储和关键服务正常后,使用 kubectl uncordon 恢复调度。它只取消节点的不可调度标记,使调度器可以再次把新 Pod 放到该节点。
基本语法
kubectl uncordon NODENODE 是要恢复调度的节点名。该命令不会重启节点,也不会主动把排空期间迁走的 Pod 调回原节点。
执行与验证
恢复 worker-1 后立即检查其不可调度状态:
kubectl uncordon worker-1
kubectl describe node worker-1 | grep -F "Unschedulable:"预期输出:首次从 cordon 状态恢复时,kubectl uncordon 会报告节点已解除 cordon;随后应看到:
Unschedulable: false如果节点此前已经可调度,首条命令的提示可能不同,但验证结果仍应为 Unschedulable: false。
恢复前检查
uncordon 只改变调度开关,不代表节点已经健康。维护闭环中应先确认节点处于可用状态,再恢复调度:
kubectl get node worker-1预期结果:节点健康状态应满足当前集群的上线条件,例如通常应为 Ready,且不再显示 SchedulingDisabled。
边界与常见误用
kubectl uncordon 不会删除节点上的 taint,也不会修复 NotReady、磁盘压力或网络异常。若节点仍有这些限制,即使 Unschedulable 已为 false,调度器也可能继续避免或无法在该节点放置 Pod。恢复调度后应继续观察节点状态和业务健康,而不是把命令成功等同于维护完成。