首页/云/云与容器速查/kubectl label 与 annotate
本包目录(340 条)
云基础概念44 条计算与存储56 条网络与安全组33 条容器与 Docker106 条
Kubernetes68 条
容器排障33 条

kubectl label 与 annotate

给资源打标签(可被选择器检索,业务语义)与注解(不可检索,存长文本/配置元数据)。两者都支持 --overwrite 覆盖与 -l 批量操作。

云与容器速查云更新于 2026-10-12
labelkubectl label pod web-1 tier=frontend --overwrite
annotatekubectl annotate deploy web kubernetes.io/change-cause="release 1.2.3"
批量kubectl label pods -l app=web version=v2 --overwrite
删除键后加 -:kubectl label pod web-1 tier-
用途标签驱动 Service/调度/告警筛选;注解存发布说明与外部集成

使用示例

使用示例
kubectl label pods -l app=web version=v2 --overwrite
kubectl annotate deploy web kubernetes.io/change-cause="release 2026-10-12"
kubectl label pod web-1 tier-
滚动更新前打 change-cause 注解,rollout history 里能直接看到每次发布说明,回滚时不再靠猜。

易错点

  • 改 Service 选择器依赖的标签:端点瞬间漂移,流量打到不该去的 Pod
  • 标签值写中文或大写:校验失败,K8s 标签值有字符集限制

数据来源与参考

  • Kubernetes Docs:kubectl label
  • Kubernetes Docs:kubectl annotate

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌