kubectl 命令详解：annotate

Posted 2022-05-03 youzhouliu

一、命令作用

更新一个或多个资源的Annotations信息。

• Annotations由key/value组成。
• Annotations的目的是存储辅助数据，特别是通过工具和系统扩展操作的数据，更多介绍在这里。
• 如果--overwrite为true，现有的annotations可以被覆盖，否则试图覆盖annotations将会报错。
• 如果设置了--resource-version，则更新将使用此resource version，否则将使用原有的resource version。

二、命令语法

annotate [--overwrite] (-f FILENAME | TYPE NAME) KEY_1=VAL_1 ... KEY_N=VAL_N [--resource-version=version]

三、使用示例

对于以下示例中，安装了 k8s 的情形下，若出现如下报错：

error: the server doesn't have a resource type "xxxx"

则需要在 kuebctl 命令前面加上 sudo 命令。

更新Pod“foo”，设置annotation “description”的value “exp_frontend”，如果同一个annotation多次设置，则只使用最后设置的value值：

kubectl annotate pods foo description='exp_frontend'

根据“pod.json”中的type和name更新pod的annotation：

kubectl annotate -f pod.json description='exp_frontend'

更新 namespace中的所有pod：

kubectl annotate pods --all description='exp_frontend running nginx'

只有当resource-version为1时，才更新pod ' foo '：

kubectl annotate pods foo description='exp_frontend running nginx' --resource-version=1

通过删除名为“description”的annotations来更新pod ' foo '。#不需要- overwrite flag：

kubectl annotate pods foo description-

四、更多可以使用 --help