1OC ADM(1)                          June 2016                         OC ADM(1)
2
3
4

NAME

6       oc adm taint - Update the taints on one or more nodes
7
8
9

SYNOPSIS

11       oc adm taint [OPTIONS]
12
13
14

DESCRIPTION

16       Update the taints on one or more nodes.
17
18              ·  A  taint consists of a key, value, and effect. As an argument
19              here, it is expressed as key=value:effect.
20
21              · The key must begin with a letter or number,  and  may  contain
22              letters,  numbers,  hyphens,  dots,  and underscores, up to  253
23              characters.
24
25              · Optionally, the key can begin with a DNS subdomain prefix  and
26              a single '/', like example.com/my-app
27
28              ·  The value must begin with a letter or number, and may contain
29              letters, numbers, hyphens, dots,  and  underscores,  up  to   63
30              characters.
31
32              · The effect must be NoSchedule, PreferNoSchedule or NoExecute.
33
34              · Currently taint can only apply to node.
35
36

OPTIONS

38       --all=false
39           Select all nodes in the cluster
40
41
42       --allow-missing-template-keys=true
43           If  true, ignore any errors in templates when a field or map key is
44       missing in the template. Only applies to  golang  and  jsonpath  output
45       formats.
46
47
48       -o, --output=""
49           Output  format. One of: json|yaml|name|template|go-template|go-tem‐
50       plate-file|templatefile|jsonpath|jsonpath-file.
51
52
53       --overwrite=false
54           If true, allow taints to be  overwritten,  otherwise  reject  taint
55       updates that overwrite existing taints.
56
57
58       -l, --selector=""
59           Selector  (label  query)  to  filter  on,  supports  '=', '==', and
60       '!='.(e.g. -l key1=value1,key2=value2)
61
62
63       --template=""
64           Template string or path to template file  to  use  when  -o=go-tem‐
65       plate,  -o=go-template-file.  The template format is golang templates [
66http://golang.org/pkg/text/template/#pkg-overview⟩].
67
68
69       --validate=false
70           If true, use a schema to validate the input before sending it
71
72
73

OPTIONS INHERITED FROM PARENT COMMANDS

75       --allow_verification_with_non_compliant_keys=false
76           Allow  a  SignatureVerifier  to  use  keys  which  are  technically
77       non-compliant with RFC6962.
78
79
80       --alsologtostderr=false
81           log to standard error as well as files
82
83
84       --application_metrics_count_limit=100
85           Max number of application metrics to store (per container)
86
87
88       --as=""
89           Username to impersonate for the operation
90
91
92       --as-group=[]
93           Group  to  impersonate for the operation, this flag can be repeated
94       to specify multiple groups.
95
96
97       --azure-container-registry-config=""
98           Path to the file containing Azure container registry  configuration
99       information.
100
101
102       --boot_id_file="/proc/sys/kernel/random/boot_id"
103           Comma-separated  list  of files to check for boot-id. Use the first
104       one that exists.
105
106
107       --cache-dir="/builddir/.kube/http-cache"
108           Default HTTP cache directory
109
110
111       --certificate-authority=""
112           Path to a cert file for the certificate authority
113
114
115       --client-certificate=""
116           Path to a client certificate file for TLS
117
118
119       --client-key=""
120           Path to a client key file for TLS
121
122
123       --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
124           CIDRs opened in GCE firewall for LB traffic proxy  health checks
125
126
127       --cluster=""
128           The name of the kubeconfig cluster to use
129
130
131       --container_hints="/etc/cadvisor/container_hints.json"
132           location of the container hints file
133
134
135       --containerd="unix:///var/run/containerd.sock"
136           containerd endpoint
137
138
139       --context=""
140           The name of the kubeconfig context to use
141
142
143       --default-not-ready-toleration-seconds=300
144           Indicates    the    tolerationSeconds   of   the   toleration   for
145       notReady:NoExecute that is added by default to every pod that does  not
146       already have such a toleration.
147
148
149       --default-unreachable-toleration-seconds=300
150           Indicates  the  tolerationSeconds  of  the  toleration for unreach‐
151       able:NoExecute that is added by default to  every  pod  that  does  not
152       already have such a toleration.
153
154
155       --docker="unix:///var/run/docker.sock"
156           docker endpoint
157
158
159       --docker-tls=false
160           use TLS to connect to docker
161
162
163       --docker-tls-ca="ca.pem"
164           path to trusted CA
165
166
167       --docker-tls-cert="cert.pem"
168           path to client certificate
169
170
171       --docker-tls-key="key.pem"
172           path to private key
173
174
175       --docker_env_metadata_whitelist=""
176           a  comma-separated  list of environment variable keys that needs to
177       be collected for docker containers
178
179
180       --docker_only=false
181           Only report docker containers in addition to root stats
182
183
184       --docker_root="/var/lib/docker"
185           DEPRECATED: docker root is read from docker info (this is  a  fall‐
186       back, default: /var/lib/docker)
187
188
189       --enable_load_reader=false
190           Whether to enable cpu load reader
191
192
193       --event_storage_age_limit="default=24h"
194           Max length of time for which to store events (per type). Value is a
195       comma separated list of key values, where  the  keys  are  event  types
196       (e.g.: creation, oom) or "default" and the value is a duration. Default
197       is applied to all non-specified event types
198
199
200       --event_storage_event_limit="default=100000"
201           Max number of events to store (per type). Value is  a  comma  sepa‐
202       rated  list  of  key values, where the keys are event types (e.g.: cre‐
203       ation, oom) or "default" and  the  value  is  an  integer.  Default  is
204       applied to all non-specified event types
205
206
207       --global_housekeeping_interval=0
208           Interval between global housekeepings
209
210
211       --housekeeping_interval=0
212           Interval between container housekeepings
213
214
215       --insecure-skip-tls-verify=false
216           If true, the server's certificate will not be checked for validity.
217       This will make your HTTPS connections insecure
218
219
220       --kubeconfig=""
221           Path to the kubeconfig file to use for CLI requests.
222
223
224       --log-flush-frequency=0
225           Maximum number of seconds between log flushes
226
227
228       --log_backtrace_at=:0
229           when logging hits line file:N, emit a stack trace
230
231
232       --log_cadvisor_usage=false
233           Whether to log the usage of the cAdvisor container
234
235
236       --log_dir=""
237           If non-empty, write log files in this directory
238
239
240       --logtostderr=true
241           log to standard error instead of files
242
243
244       --machine_id_file="/etc/machine-id,/var/lib/dbus/machine-id"
245           Comma-separated list of files to  check  for  machine-id.  Use  the
246       first one that exists.
247
248
249       --match-server-version=false
250           Require server version to match client version
251
252
253       -n, --namespace=""
254           If present, the namespace scope for this CLI request
255
256
257       --request-timeout="0"
258           The  length  of  time  to  wait before giving up on a single server
259       request. Non-zero values should contain a corresponding time unit (e.g.
260       1s, 2m, 3h). A value of zero means don't timeout requests.
261
262
263       -s, --server=""
264           The address and port of the Kubernetes API server
265
266
267       --stderrthreshold=2
268           logs at or above this threshold go to stderr
269
270
271       --storage_driver_buffer_duration=0
272           Writes  in  the  storage driver will be buffered for this duration,
273       and committed to the non memory backends as a single transaction
274
275
276       --storage_driver_db="cadvisor"
277           database name
278
279
280       --storage_driver_host="localhost:8086"
281           database host:port
282
283
284       --storage_driver_password="root"
285           database password
286
287
288       --storage_driver_secure=false
289           use secure connection with database
290
291
292       --storage_driver_table="stats"
293           table name
294
295
296       --storage_driver_user="root"
297           database username
298
299
300       --token=""
301           Bearer token for authentication to the API server
302
303
304       --user=""
305           The name of the kubeconfig user to use
306
307
308       -v, --v=0
309           log level for V logs
310
311
312       --version=false
313           Print version information and quit
314
315
316       --vmodule=
317           comma-separated list of pattern=N settings for  file-filtered  log‐
318       ging
319
320
321

EXAMPLE

323                # Update node 'foo' with a taint with key 'dedicated' and value 'special-user' and effect 'NoSchedule'.
324                # If a taint with that key and effect already exists, its value is replaced as specified.
325                oc adm taint nodes foo dedicated=special-user:NoSchedule
326
327                # Remove from node 'foo' the taint with key 'dedicated' and effect 'NoSchedule' if one exists.
328                oc adm taint nodes foo dedicated:NoSchedule-
329
330                # Remove from node 'foo' all the taints with key 'dedicated'
331                oc adm taint nodes foo dedicated-
332
333                # Add a taint with key 'dedicated' on nodes having label mylabel=X
334                oc adm taint node -l myLabel=X  dedicated=foo:PreferNoSchedule
335
336
337
338

SEE ALSO

340       oc-adm(1),
341
342
343

HISTORY

345       June 2016, Ported from the Kubernetes man-doc generator
346
347
348
349Openshift                  Openshift CLI User Manuals                OC ADM(1)
Impressum