1KUBERNETES(1)                      Jan 2015                      KUBERNETES(1)
2
3
4

NAME

6       kubectl config - Modify kubeconfig files
7
8
9

SYNOPSIS

11       kubectl config [OPTIONS]
12
13
14

DESCRIPTION

16       Modify kubeconfig files using subcommands like "kubectl config set cur‐
17       rent-context my-context"
18
19
20       The loading order follows these rules:
21
22       ·
23
24         item If the --kubeconfig flag is set, then only that file is  loaded.
25         The  flag  may  only be set once and no merging takes place.  item If
26         $KUBECONFIG environment variable is set, then it is used as a list of
27         paths (normal path delimiting rules for your system). These paths are
28         merged. When a value is modified, it is modified  in  the  file  that
29         defines  the  stanza.  When  a value is created, it is created in the
30         first file that exists. If no files in the chain exist, then it  cre‐
31         ates the last file in the list.  item Otherwise, ${HOME}/.kube/config
32         is used and no merging takes place.
33
34

OPTIONS INHERITED FROM PARENT COMMANDS

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

SEE ALSO

321       kubectl(1),       kubectl-config-current-context(1),       kubectl-con‐
322       fig-delete-cluster(1),  kubectl-config-delete-context(1),  kubectl-con‐
323       fig-get-clusters(1),    kubectl-config-get-contexts(1),    kubectl-con‐
324       fig-rename-context(1),  kubectl-config-set(1), kubectl-config-set-clus‐
325       ter(1),    kubectl-config-set-context(1),    kubectl-config-set-creden‐
326       tials(1),    kubectl-config-unset(1),    kubectl-config-use-context(1),
327       kubectl-config-view(1),
328
329
330

HISTORY

332       January 2015, Originally compiled by Eric Paris (eparis at  redhat  dot
333       com)  based  on the kubernetes source material, but hopefully they have
334       been automatically generated since!
335
336
337
338Eric Paris                  kubernetes User Manuals              KUBERNETES(1)
Impressum