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

kubectl annotate 管理注解

注解存任意非标识性元数据,很多控制器靠注解驱动行为:Ingress 规则、证书签发、Prometheus 抓取开关都通过注解配置。

Kubernetes 速查云更新于 2026-10-12
用途增改删资源注解(key=value,值只能是字符串)
语法kubectl annotate <资源> <名称> <key>=<value> [--overwrite]

常用示例

常用示例
kubectl annotate deploy web owner="team-a"
kubectl annotate ingress web nginx.ingress.kubernetes.io/rewrite-target=/
kubectl annotate deploy web kubernetes.io/change-cause="rollout to 1.25.3"
kubectl annotate deploy web owner-   # 删除注解
注解适合放变更原因、负责人、外部系统引用;不适合放会被选择器匹配的标识信息(那是标签的职责)。

易错点

  • 删除注解同样是 key 后加 -;误删旧注解可能导致控制器行为突变(如 Ingress 重写规则失效)
  • 注解值只能是字符串,数字/布尔写进去也是字符串,控制器自行解析

数据来源与参考

  • Kubernetes 官方文档 · kubectl annotate / Annotations
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌