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.
26         item If $KUBECONFIG environment variable is set, then it is used as a
27         list of paths (normal path delimitting rules for your system).  These
28         paths  are  merged.  When  a value is modified, it is modified in the
29         file that defines the stanza. When a value is created, it is  created
30         in  the  first file that exists. If no files in the chain exist, then
31         it creates the last file in the list.
32         item Otherwise, ${HOME}/.kube/config is used  and  no  merging  takes
33         place.
34
35

OPTIONS INHERITED FROM PARENT COMMANDS

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

SEE ALSO

313       kubectl(1),       kubectl-config-current-context(1),       kubectl-con‐
314       fig-delete-cluster(1),  kubectl-config-delete-context(1),  kubectl-con‐
315       fig-get-clusters(1),    kubectl-config-get-contexts(1),    kubectl-con‐
316       fig-rename-context(1),  kubectl-config-set(1), kubectl-config-set-clus‐
317       ter(1),    kubectl-config-set-context(1),    kubectl-config-set-creden‐
318       tials(1),    kubectl-config-unset(1),    kubectl-config-use-context(1),
319       kubectl-config-view(1),
320
321
322

HISTORY

324       January 2015, Originally compiled by Eric Paris (eparis at  redhat  dot
325       com)  based  on the kubernetes source material, but hopefully they have
326       been automatically generated since!
327
328
329
330Eric Paris                  kubernetes User Manuals              KUBERNETES(1)
Impressum