kx label
Sets or removes labels on one indexed resource — key=value to set, --remove to drop a key.
A flag kx doesn’t know is refused; put it after -- to pass it through to kubectl.
Usage
kx label [OPTIONS] <index> [key=value...] [kubectl flags]Arguments
| Argument | Description |
|---|---|
<index> | Row number from the current listing, or @name for a mark; kx state or kx mark shows them |
[key=value]... | Key and value to set; repeatable |
Options
| Option | Description |
|---|---|
--dry-run[=string] | client or server to preview the change without making it, as kubectl takes it; kx’s line says nothing was changed |
-o, --output string | Output format, as kubectl takes it; kubectl’s output is printed, and kx’s own lines go to stderr |
--overwrite | Allow replacing an existing key |
--remove strings | Key to remove (repeatable) |
Passthrough options
| Option | Description |
|---|---|
--all | Select all resources, in the namespace of the specified resource types |
-A, --all-namespaces | If true, check the specified action in all namespaces. |
--allow-missing-template-keys | If true, ignore any errors in templates when a field or map key is missing in the template. Only applies to golang and jsonpath output formats. |
--field-manager string | Name of the manager used to track field ownership. |
--field-selector string | Selector (field query) to filter on, supports ‘=’, ‘==’, and ‘!=’.(e.g. --field-selector key1=value1,key2=value2). The server only supports a limited number of field queries per type. |
-f, --filename strings | Filename, directory, or URL to files identifying the resource to update the labels |
-k, --kustomize string | Process the kustomization directory. This flag can’t be used together with -f or -R. |
--list | If true, display the labels for a given resource. |
--local | If true, label will NOT contact api-server but run locally. |
-R, --recursive | Process the directory used in -f, --filename recursively. Useful when you want to manage related manifests organized within the same directory. |
--resource-version string | If non-empty, the labels update will only succeed if this is the current resource-version for the object. Only valid when specifying a single resource. |
-l, --selector string | Selector (label query) to filter on, supports ‘=’, ‘==’, ‘!=’, ‘in’, ’notin’.(e.g. -l key1=value1,key2=value2,key3 in (value3)). Matching objects must satisfy all of the specified label constraints. |
--show-managed-fields | If true, keep the managedFields when printing objects in JSON or YAML format. |
--template string | Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. |
… | kubectl’s global flags too: --context, --kubeconfig, --as and the rest; kubectl options lists them |
Global options
| Option | Description |
|---|---|
--no-color | Disable styled output |
-h, --help | Show this message and exit |
Examples
kx label 1 env=prod
kx label 1 --remove env
kx label 1 env=prod --dry-run=server