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

NAME

9       kubectl config get-contexts - Describe one or many contexts
10
11
12

SYNOPSIS

14       kubectl config get-contexts [OPTIONS]
15
16
17

DESCRIPTION

19       Displays one or many contexts from the kubeconfig file.
20
21
22

OPTIONS

24       --no-headers=false       When using the default or custom-column output
25       format, don't print headers (default print headers).
26
27
28       -o, --output=""      Output format. One of: name
29
30
31

OPTIONS INHERITED FROM PARENT COMMANDS

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

EXAMPLE

310                # List all the contexts in your kubeconfig file
311                kubectl config get-contexts
312
313                # Describe one context in your kubeconfig file.
314                kubectl config get-contexts my-context
315
316
317
318

SEE ALSO

320       kubectl-config(1),
321
322
323

HISTORY

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