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

NAME

9       kubectl rollout status - Show the status of the rollout
10
11
12

SYNOPSIS

14       kubectl rollout status [OPTIONS]
15
16
17

DESCRIPTION

19       Show the status of the rollout.
20
21
22       By default 'rollout status' will watch the status of the latest rollout
23       until it's done. If you don't want to wait for the  rollout  to  finish
24       then  you  can  use  --watch=false.  Note  that if a new rollout starts
25       in-between, then 'rollout status' will continue watching the latest re‐
26       vision.  If  you  want to pin to a specific revision and abort if it is
27       rolled over by another revision, use --revision=N where N is the  revi‐
28       sion you need to watch for.
29
30
31

OPTIONS

33       -f, --filename=[]      Filename, directory, or URL to files identifying
34       the resource to get from a server.
35
36
37       -k, --kustomize=""      Process the kustomization directory. This  flag
38       can't be used together with -f or -R.
39
40
41       -R, --recursive=false      Process the directory used in -f, --filename
42       recursively. Useful when you want to manage related manifests organized
43       within the same directory.
44
45
46       --revision=0       Pin  to  a specific revision for showing its status.
47       Defaults to 0 (last revision).
48
49
50       --timeout=0s      The length of time to wait before ending watch,  zero
51       means  never. Any other values should contain a corresponding time unit
52       (e.g. 1s, 2m, 3h).
53
54
55       -w, --watch=true      Watch the status of the rollout until it's done.
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=""      Path to the kubeconfig file to  use  for  CLI  re‐
198       quests.
199
200
201       --log-backtrace-at=:0       when logging hits line file:N, emit a stack
202       trace
203
204
205       --log-cadvisor-usage=false      Whether to log the usage of the  cAdvi‐
206       sor container
207
208
209       --log-dir=""      If non-empty, write log files in this directory
210
211
212       --log-file=""      If non-empty, use this log file
213
214
215       --log-file-max-size=1800       Defines  the maximum size a log file can
216       grow to. Unit is megabytes. If the value is 0, the maximum file size is
217       unlimited.
218
219
220       --log-flush-frequency=5s       Maximum  number  of  seconds between log
221       flushes
222
223
224       --logtostderr=true      log to standard error instead of files
225
226
227       --machine-id-file="/etc/machine-id,/var/lib/dbus/machine-id"
228            Comma-separated  list  of  files  to check for machine-id. Use the
229       first one that exists.
230
231
232       --match-server-version=false       Require  server  version  to   match
233       client version
234
235
236       -n,  --namespace=""       If  present, the namespace scope for this CLI
237       request
238
239
240       --one-output=false      If true, only write logs to their native sever‐
241       ity level (vs also writing to each lower severity level
242
243
244       --password=""      Password for basic authentication to the API server
245
246
247       --profile="none"         Name   of   profile   to   capture.   One   of
248       (none|cpu|heap|goroutine|threadcreate|block|mutex)
249
250
251       --profile-output="profile.pprof"      Name of the  file  to  write  the
252       profile to
253
254
255       --referenced-reset-interval=0       Reset interval for referenced bytes
256       (container_referenced_bytes metric), number of measurement cycles after
257       which  referenced  bytes  are cleared, if set to 0 referenced bytes are
258       never cleared (default: 0)
259
260
261       --request-timeout="0"      The length of time to wait before giving  up
262       on  a  single  server  request. Non-zero values should contain a corre‐
263       sponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't time‐
264       out requests.
265
266
267       -s, --server=""      The address and port of the Kubernetes API server
268
269
270       --skip-headers=false       If  true,  avoid  header prefixes in the log
271       messages
272
273
274       --skip-log-headers=false      If true, avoid headers when  opening  log
275       files
276
277
278       --stderrthreshold=2      logs at or above this threshold go to stderr
279
280
281       --storage-driver-buffer-duration=1m0s      Writes in the storage driver
282       will be buffered for this duration, and committed  to  the  non  memory
283       backends as a single transaction
284
285
286       --storage-driver-db="cadvisor"      database name
287
288
289       --storage-driver-host="localhost:8086"      database host:port
290
291
292       --storage-driver-password="root"      database password
293
294
295       --storage-driver-secure=false      use secure connection with database
296
297
298       --storage-driver-table="stats"      table name
299
300
301       --storage-driver-user="root"      database username
302
303
304       --tls-server-name=""       Server  name  to  use for server certificate
305       validation. If it is not provided, the hostname  used  to  contact  the
306       server is used
307
308
309       --token=""      Bearer token for authentication to the API server
310
311
312       --update-machine-info-interval=5m0s       Interval between machine info
313       updates.
314
315
316       --user=""      The name of the kubeconfig user to use
317
318
319       --username=""      Username for basic authentication to the API server
320
321
322       -v, --v=0      number for the log level verbosity
323
324
325       --version=false      Print version information and quit
326
327
328       --vmodule=       comma-separated  list  of   pattern=N   settings   for
329       file-filtered logging
330
331
332       --warnings-as-errors=false      Treat warnings received from the server
333       as errors and exit with a non-zero exit code
334
335
336

EXAMPLE

338                # Watch the rollout status of a deployment
339                kubectl rollout status deployment/nginx
340
341
342
343

SEE ALSO

345       kubectl-rollout(1),
346
347
348

HISTORY

350       January 2015, Originally compiled by Eric Paris (eparis at  redhat  dot
351       com)  based  on the kubernetes source material, but hopefully they have
352       been automatically generated since!
353
354
355
356Manuals                              User            KUBERNETES(1)(kubernetes)
Impressum