kubectl annotate
更新一个或多个资源的Annotations信息。
- Annotations由key/value组成。
- Annotations的目的是存储辅助数据，特别是通过工具和系统扩展操作的数据。
- 如果–overwrite为true，现有的annotations可以被覆盖，否则试图覆盖annotations将会报错。
- 如果设置了–resource-version，则更新将使用此resource version，否则将使用原有的resource version。
有效资源类型包括：
- all
- certificatesigningrequests (aka \’csr\’)
- clusterrolebindings
- clusterroles
- clusters (valid only for federation apiservers)
- componentstatuses (aka \’cs\’)
- configmaps (aka \’cm\’)
- controllerrevisions
- cronjobs
- daemonsets (aka \’ds\’)
- deployments (aka \’deploy\’)
- endpoints (aka \’ep\’)
- events (aka \’ev\’)
- horizontalpodautoscalers (aka \’hpa\’)
- ingresses (aka \’ing\’)
- jobs
- limitranges (aka \’limits\’)
- namespaces (aka \’ns\’)
- networkpolicies (aka \’netpol\’)
- nodes (aka \’no\’)
- persistentvolumeclaims (aka \’pvc\’)
- persistentvolumes (aka \’pv\’)
- poddisruptionbudgets (aka \’pdb\’)
- podpreset
- pods (aka \’po\’)
- podsecuritypolicies (aka \’psp\’)
- podtemplates
- replicasets (aka \’rs\’)
- replicationcontrollers (aka \’rc\’)
- resourcequotas (aka \’quota\’)
- rolebindings
- roles
- secrets
- serviceaccounts (aka \’sa\’)
- services (aka \’svc\’)
- statefulsets
- storageclasses
- thirdpartyresources
语法
$ annotate [--overwrite] (-f FILENAME | TYPE NAME) KEY_1=VAL_1 ... KEY_N=VAL_N [--resource-version=version]
示例
更新Pod“foo”，设置annotation “description”的value “my frontend”，如果同一个annotation多次设置，则只使用最后设置的value值。
kubectl annotate pods foo description=\'my frontend\'
根据“pod.json”中的type和name更新pod的annotation
kubectl annotate -f pod.json description=\'my frontend\'
更新Pod\”foo\”，设置annotation“description”的value“my frontend running nginx”，覆盖现有的值。
kubectl annotate --overwrite pods foo description=\'my frontend running nginx\'
更新 namespace中的所有pod
kubectl annotate pods --all description=\'my frontend running nginx\'
只有当resource-version为1时，才更新pod \’ foo \’。
kubectl annotate pods foo description=\'my frontend running nginx\' --resource-version=1
通过删除名为“description”的annotations来更新pod \’ foo \’。#不需要- overwrite flag。
kubectl annotate pods foo description-