1KUBERNETES(1)(kubernetes) KUBERNETES(1)(kubernetes)
2Eric Paris Jan 2015
6
9 kubectl set selector - Set the selector on a resource
10
14 kubectl set selector [OPTIONS]
15
19 Set the selector on a resource. Note that the new selector will over‐
20 write the old selector if the resource had one prior to the invocation
21 of 'set selector'.
22 A selector must begin with a letter or number, and may contain letters,
25 numbers, hyphens, dots, and underscores, up to 63 characters. If --re‐
26 source-version is specified, then updates will use this resource ver‐
27 sion, otherwise the existing resource-version will be used. Note: cur‐
28 rently selectors can only be set on Service objects.
29
33 --all=false Select all resources in the namespace of the specified
34 resource types
35 --allow-missing-template-keys=true If true, ignore any errors in
38 templates when a field or map key is missing in the template. Only ap‐
39 plies to golang and jsonpath output formats.
40 --dry-run="none" Must be "none", "server", or "client". If client
43 strategy, only print the object that would be sent, without sending it.
44 If server strategy, submit server-side request without persisting the
45 resource.
46 --field-manager="kubectl-set" Name of the manager used to track
49 field ownership.
50 -f, --filename=[] identifying the resource.
53 --local=false If true, annotation will NOT contact api-server but
56 run locally.
57 -o, --output="" Output format. One of: json|yaml|name|go-tem‐
60 plate|go-template-file|template|templatefile|jsonpath|json‐
61 path-as-json|jsonpath-file.
62 --record=false Record current kubectl command in the resource an‐
65 notation. If set to false, do not record the command. If set to true,
66 record the command. If not set, default to updating the existing anno‐
67 tation value only if one already exists.
68 -R, --recursive=true Process the directory used in -f, --filename
71 recursively. Useful when you want to manage related manifests organized
72 within the same directory.
73 --resource-version="" If non-empty, the selectors update will only
76 succeed if this is the current resource-version for the object. Only
77 valid when specifying a single resource.
78 --show-managed-fields=false If true, keep the managedFields when
81 printing objects in JSON or YAML format.
82 --template="" Template string or path to template file to use when
85 -o=go-template, -o=go-template-file. The template format is golang tem‐
86 plates [http://golang.org/pkg/text/template/#pkg-overview].
87
91 --add-dir-header=false If true, adds the file directory to the
92 header of the log messages
93 --alsologtostderr=false log to standard error as well as files
96 --application-metrics-count-limit=100 Max number of application
99 metrics to store (per container)
100 --as="" Username to impersonate for the operation
103 --as-group=[] Group to impersonate for the operation, this flag
106 can be repeated to specify multiple groups.
107 --azure-container-registry-config="" Path to the file containing
110 Azure container registry configuration information.
111 --boot-id-file="/proc/sys/kernel/random/boot_id" Comma-separated
114 list of files to check for boot-id. Use the first one that exists.
115 --cache-dir="/builddir/.kube/cache" Default cache directory
118 --certificate-authority="" Path to a cert file for the certificate
121 authority
122 --client-certificate="" Path to a client certificate file for TLS
125 --client-key="" Path to a client key file for TLS
128 --cloud-provider-gce-l7lb-src-cidrs=130.211.0.0/22,35.191.0.0/16
131 CIDRs opened in GCE firewall for L7 LB traffic proxy health
132 checks
133 --cloud-provider-gce-lb-src-cidrs=130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16
136 CIDRs opened in GCE firewall for L4 LB traffic proxy health
137 checks
138 --cluster="" The name of the kubeconfig cluster to use
141 --container-hints="/etc/cadvisor/container_hints.json" location of
144 the container hints file
145 --containerd="/run/containerd/containerd.sock" containerd endpoint
148 --containerd-namespace="k8s.io" containerd namespace
151 --context="" The name of the kubeconfig context to use
154 --default-not-ready-toleration-seconds=300 Indicates the tolera‐
157 tionSeconds of the toleration for notReady:NoExecute that is added by
158 default to every pod that does not already have such a toleration.
159 --default-unreachable-toleration-seconds=300 Indicates the tolera‐
162 tionSeconds of the toleration for unreachable:NoExecute that is added
163 by default to every pod that does not already have such a toleration.
164 --disable-root-cgroup-stats=false Disable collecting root Cgroup
167 stats
168 --docker="unix:///var/run/docker.sock" docker endpoint
171 --docker-env-metadata-whitelist="" a comma-separated list of envi‐
174 ronment variable keys matched with specified prefix that needs to be
175 collected for docker containers
176 --docker-only=false Only report docker containers in addition to
179 root stats
180 --docker-root="/var/lib/docker" DEPRECATED: docker root is read
183 from docker info (this is a fallback, default: /var/lib/docker)
184 --docker-tls=false use TLS to connect to docker
187 --docker-tls-ca="ca.pem" path to trusted CA
190 --docker-tls-cert="cert.pem" path to client certificate
193 --docker-tls-key="key.pem" path to private key
196 --enable-load-reader=false Whether to enable cpu load reader
199 --event-storage-age-limit="default=0" Max length of time for which
202 to store events (per type). Value is a comma separated list of key val‐
203 ues, where the keys are event types (e.g.: creation, oom) or "default"
204 and the value is a duration. Default is applied to all non-specified
205 event types
206 --event-storage-event-limit="default=0" Max number of events to
209 store (per type). Value is a comma separated list of key values, where
210 the keys are event types (e.g.: creation, oom) or "default" and the
211 value is an integer. Default is applied to all non-specified event
212 types
213 --global-housekeeping-interval=1m0s Interval between global house‐
216 keepings
217 --housekeeping-interval=10s Interval between container housekeep‐
220 ings
221 --insecure-skip-tls-verify=false If true, the server's certificate
224 will not be checked for validity. This will make your HTTPS connections
225 insecure
226 --kubeconfig="" Path to the kubeconfig file to use for CLI re‐
229 quests.
230 --log-backtrace-at=:0 when logging hits line file:N, emit a stack
233 trace
234 --log-cadvisor-usage=false Whether to log the usage of the cAdvi‐
237 sor container
238 --log-dir="" If non-empty, write log files in this directory
241 --log-file="" If non-empty, use this log file
244 --log-file-max-size=1800 Defines the maximum size a log file can
247 grow to. Unit is megabytes. If the value is 0, the maximum file size is
248 unlimited.
249 --log-flush-frequency=5s Maximum number of seconds between log
252 flushes
253 --logtostderr=true log to standard error instead of files
256 --machine-id-file="/etc/machine-id,/var/lib/dbus/machine-id"
259 Comma-separated list of files to check for machine-id. Use the
260 first one that exists.
261 --match-server-version=false Require server version to match
264 client version
265 -n, --namespace="" If present, the namespace scope for this CLI
268 request
269 --one-output=false If true, only write logs to their native sever‐
272 ity level (vs also writing to each lower severity level)
273 --password="" Password for basic authentication to the API server
276 --profile="none" Name of profile to capture. One of
279 (none|cpu|heap|goroutine|threadcreate|block|mutex)
280 --profile-output="profile.pprof" Name of the file to write the
283 profile to
284 --referenced-reset-interval=0 Reset interval for referenced bytes
287 (container_referenced_bytes metric), number of measurement cycles after
288 which referenced bytes are cleared, if set to 0 referenced bytes are
289 never cleared (default: 0)
290 --request-timeout="0" The length of time to wait before giving up
293 on a single server request. Non-zero values should contain a corre‐
294 sponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't time‐
295 out requests.
296 -s, --server="" The address and port of the Kubernetes API server
299 --skip-headers=false If true, avoid header prefixes in the log
302 messages
303 --skip-log-headers=false If true, avoid headers when opening log
306 files
307 --stderrthreshold=2 logs at or above this threshold go to stderr
310 --storage-driver-buffer-duration=1m0s Writes in the storage driver
313 will be buffered for this duration, and committed to the non memory
314 backends as a single transaction
315 --storage-driver-db="cadvisor" database name
318 --storage-driver-host="localhost:8086" database host:port
321 --storage-driver-password="root" database password
324 --storage-driver-secure=false use secure connection with database
327 --storage-driver-table="stats" table name
330 --storage-driver-user="root" database username
333 --tls-server-name="" Server name to use for server certificate
336 validation. If it is not provided, the hostname used to contact the
337 server is used
338 --token="" Bearer token for authentication to the API server
341 --update-machine-info-interval=5m0s Interval between machine info
344 updates.
345 --user="" The name of the kubeconfig user to use
348 --username="" Username for basic authentication to the API server
351 -v, --v=0 number for the log level verbosity
354 --version=false Print version information and quit
357 --vmodule= comma-separated list of pattern=N settings for
360 file-filtered logging
361 --warnings-as-errors=false Treat warnings received from the server
364 as errors and exit with a non-zero exit code
365
369 # set the labels and selector before creating a deployment/service pair.
370 kubectl create service clusterip my-svc --clusterip="None" -o yaml --dry-run=client | kubectl set selector --local -f - 'environment=qa' -o yaml | kubectl create -f -
371 kubectl create deployment my-dep -o yaml --dry-run=client | kubectl label --local -f - environment=qa -o yaml | kubectl create -f -
372
377 kubectl-set(1),
378
382 January 2015, Originally compiled by Eric Paris (eparis at redhat dot
383 com) based on the kubernetes source material, but hopefully they have
384 been automatically generated since!
385Manuals User KUBERNETES(1)(kubernetes)