1KUBERNETES(1)                      Jan 2015                      KUBERNETES(1)
2
3
4

NAME

6       kubectl rollout status - Show the status of the rollout
7
8
9

SYNOPSIS

11       kubectl rollout status [OPTIONS]
12
13
14

DESCRIPTION

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

OPTIONS

30       -f, --filename=[]
31           Filename,  directory,  or  URL to files identifying the resource to
32       get from a server.
33
34
35       -k, --kustomize=""
36           Process the  kustomization  directory.  This  flag  can't  be  used
37       together with -f or -R.
38
39
40       -R, --recursive=false
41           Process  the  directory  used in -f, --filename recursively. Useful
42       when you want to manage related manifests  organized  within  the  same
43       directory.
44
45
46       --revision=0
47           Pin  to  a  specific revision for showing its status. Defaults to 0
48       (last revision).
49
50
51       --timeout=0s
52           The length of time to wait before ending watch, zero  means  never.
53       Any other values should contain a corresponding time unit (e.g. 1s, 2m,
54       3h).
55
56
57       -w, --watch=true
58           Watch the status of the rollout until it's done.
59
60
61

OPTIONS INHERITED FROM PARENT COMMANDS

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

EXAMPLE

348                # Watch the rollout status of a deployment
349                kubectl rollout status deployment/nginx
350
351
352
353

SEE ALSO

355       kubectl-rollout(1),
356
357
358

HISTORY

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