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       --template=""      Template string or path to template file to use when
54       -o=go-template, -o=go-template-file. The template format is golang tem‐
55       plates [http://golang.org/pkg/text/template/#pkg-overview].
56
57
58

OPTIONS INHERITED FROM PARENT COMMANDS

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

EXAMPLE

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

SEE ALSO

350       kubectl-config(1),
351
352
353

HISTORY

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