1KUBERNETES(1)(kubernetes)                            KUBERNETES(1)(kubernetes)
2
3
4
5Eric Paris Jan 2015
6
7

NAME

9       kubectl config view - Display merged kubeconfig settings or a specified
10       kubeconfig file
11
12
13

SYNOPSIS

15       kubectl config view [OPTIONS]
16
17
18

DESCRIPTION

20       Display merged kubeconfig settings or a specified kubeconfig file.
21
22
23       You can use --output jsonpath={...} to extract specific values using  a
24       jsonpath expression.
25
26
27

OPTIONS

29       --allow-missing-template-keys=true       If  true, ignore any errors in
30       templates when a field or map key is missing in the template. Only  ap‐
31       plies to golang and jsonpath output formats.
32
33
34       --flatten=false        Flatten   the  resulting  kubeconfig  file  into
35       self-contained output (useful for creating portable kubeconfig files)
36
37
38       --merge=true      Merge the full hierarchy of kubeconfig files
39
40
41       --minify=false      Remove all information not used by  current-context
42       from the output
43
44
45       -o,  --output="yaml"      Output format. One of: json|yaml|name|go-tem‐
46       plate|go-template-file|template|templatefile|jsonpath|json‐
47       path-as-json|jsonpath-file.
48
49
50       --raw=false      Display raw byte data
51
52
53       --show-managed-fields=false       If  true, keep the managedFields when
54       printing objects in JSON or YAML format.
55
56
57       --template=""      Template string or path to template file to use when
58       -o=go-template, -o=go-template-file. The template format is golang tem‐
59       plates [http://golang.org/pkg/text/template/#pkg-overview].
60
61
62

OPTIONS INHERITED FROM PARENT COMMANDS

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

EXAMPLE

341                # Show merged kubeconfig settings.
342                kubectl config view
343
344                # Show merged kubeconfig settings and raw certificate data.
345                kubectl config view --raw
346
347                # Get the password for the e2e user
348                kubectl config view -o jsonpath='{.users[?(@.name == "e2e")].user.password}'
349
350
351
352

SEE ALSO

354       kubectl-config(1),
355
356
357

HISTORY

359       January  2015,  Originally compiled by Eric Paris (eparis at redhat dot
360       com) based on the kubernetes source material, but hopefully  they  have
361       been automatically generated since!
362
363
364
365Manuals                              User            KUBERNETES(1)(kubernetes)
Impressum