kubectl 命令详解（十一）：label

一、命令作用

更新（增加、修改或删除）资源上的 label（标签）。

• label 必须以字母或数字开头，可以使用字母、数字、连字符、点和下划线，最长63个字符。
• 如果--overwrite 为 true，则可以覆盖已有的 label，否则尝试覆盖 label 将会报错。
• 如果指定了--resource-version，则更新将使用此资源版本，否则将使用现有的资源版本。

二、命令语法

label [--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 命令。

给名为 exp 的 Pod 添加 label unhealthy=true：

kubectl label pods exp unhealthy=true

给名为 exp 的 Pod 修改 label 为 'status' / value 'unhealthy'，且覆盖现有的 value：

kubectl label --overwrite pods exp status=unhealthy

给 namespace 中的所有 pod 添加 label：

kubectl label pods --all status=unhealthy

仅当 resource-version=1 时才更新名为 exp 的 Pod 上的 label：

kubectl label pods exp status=unhealthy --resource-version=1

删除名为 test 的 label （使用“ - ”减号相连）：

kubectl label pods exp test-

四、更多可以使用 --help