首页/云/Kubernetes 速查/kubectl label 管理资源标签
本包目录(307 条)
kubectl 基础56 条
工作负载36 条网络与服务55 条配置与存储54 条调度与资源52 条集群运维与排障54 条

kubectl label 管理资源标签

给资源打标签/改标签/去标签;标签是选择器(Service、Deployment、NetworkPolicy)关联对象的主要依据,改错直接影响配对。

Kubernetes 速查云更新于 2026-10-12
用途增改删资源标签(key=value)
语法kubectl label <资源> <名称> <key>=<value> [--overwrite]

常用示例

常用示例
kubectl label pod web-x env=prod
kubectl label node node-1 disktype=ssd
kubectl label pod web-x env=staging --overwrite
kubectl label pod web-x env-          # 删除标签
kubectl get pods -l env=prod --show-labels
标签键若已存在,不加 --overwrite 会报错而不是静默覆盖——这是防误改的保护。

易错点

  • 改动带控制器的 Pod 标签会使其脱离 ReplicaSet 管理,可能被重建并在原集合外残留
  • 标签键前缀(如 app.kubernetes.io/name)是规范推荐写法,手写时不要拼错域名段

数据来源与参考

  • Kubernetes 官方文档 · kubectl label
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌