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

NAME

9       kubectl cluster-info - Display cluster info
10
11
12

SYNOPSIS

14       kubectl cluster-info [OPTIONS]
15
16
17

DESCRIPTION

19       Display  addresses  of the control plane and services with label kuber‐
20       netes.io/cluster-service=true To further  debug  and  diagnose  cluster
21       problems, use 'kubectl cluster-info dump'.
22
23
24

OPTIONS INHERITED FROM PARENT COMMANDS

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

EXAMPLE

304                # Print the address of the control plane and cluster services
305                kubectl cluster-info
306
307
308
309

SEE ALSO

311       kubectl(1), kubectl-cluster-info-dump(1),
312
313
314

HISTORY

316       January  2015,  Originally compiled by Eric Paris (eparis at redhat dot
317       com) based on the kubernetes source material, but hopefully  they  have
318       been automatically generated since!
319
320
321
322Manuals                              User            KUBERNETES(1)(kubernetes)
Impressum