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       -R, --recursive=false
36           Process the directory used in -f,  --filename  recursively.  Useful
37       when  you  want  to  manage related manifests organized within the same
38       directory.
39
40
41       --revision=0
42           Pin to a specific revision for showing its status.  Defaults  to  0
43       (last revision).
44
45
46       --timeout=0s
47           The  length  of time to wait before ending watch, zero means never.
48       Any other values should contain a corresponding time unit (e.g. 1s, 2m,
49       3h).
50
51
52       -w, --watch=true
53           Watch the status of the rollout until it's done.
54
55
56

OPTIONS INHERITED FROM PARENT COMMANDS

58       --allow-verification-with-non-compliant-keys=false
59           Allow  a  SignatureVerifier  to  use  keys  which  are  technically
60       non-compliant with RFC6962.
61
62
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="unix:///var/run/containerd.sock"
119           containerd endpoint
120
121
122       --context=""
123           The name of the kubeconfig context to use
124
125
126       --default-not-ready-toleration-seconds=300
127           Indicates   the   tolerationSeconds   of   the    toleration    for
128       notReady:NoExecute  that is added by default to every pod that does not
129       already have such a toleration.
130
131
132       --default-unreachable-toleration-seconds=300
133           Indicates the tolerationSeconds  of  the  toleration  for  unreach‐
134       able:NoExecute  that  is  added  by  default to every pod that does not
135       already have such a toleration.
136
137
138       --docker="unix:///var/run/docker.sock"
139           docker endpoint
140
141
142       --docker-env-metadata-whitelist=""
143           a comma-separated list of environment variable keys that  needs  to
144       be collected for docker containers
145
146
147       --docker-only=false
148           Only report docker containers in addition to root stats
149
150
151       --docker-root="/var/lib/docker"
152           DEPRECATED:  docker  root is read from docker info (this is a fall‐
153       back, default: /var/lib/docker)
154
155
156       --docker-tls=false
157           use TLS to connect to docker
158
159
160       --docker-tls-ca="ca.pem"
161           path to trusted CA
162
163
164       --docker-tls-cert="cert.pem"
165           path to client certificate
166
167
168       --docker-tls-key="key.pem"
169           path to private key
170
171
172       --enable-load-reader=false
173           Whether to enable cpu load reader
174
175
176       --event-storage-age-limit="default=0"
177           Max length of time for which to store events (per type). Value is a
178       comma  separated  list  of  key  values, where the keys are event types
179       (e.g.: creation, oom) or "default" and the value is a duration. Default
180       is applied to all non-specified event types
181
182
183       --event-storage-event-limit="default=0"
184           Max  number  of  events to store (per type). Value is a comma sepa‐
185       rated list of key values, where the keys are event  types  (e.g.:  cre‐
186       ation,  oom)  or  "default"  and  the  value  is an integer. Default is
187       applied to all non-specified event types
188
189
190       --global-housekeeping-interval=1m0s
191           Interval between global housekeepings
192
193
194       --google-json-key=""
195           The Google Cloud Platform Service  Account  JSON  Key  to  use  for
196       authentication.
197
198
199       --housekeeping-interval=10s
200           Interval between container housekeepings
201
202
203       --insecure-skip-tls-verify=false
204           If true, the server's certificate will not be checked for validity.
205       This will make your HTTPS connections insecure
206
207
208       --kubeconfig=""
209           Path to the kubeconfig file to use for CLI requests.
210
211
212       --log-backtrace-at=:0
213           when logging hits line file:N, emit a stack trace
214
215
216       --log-cadvisor-usage=false
217           Whether to log the usage of the cAdvisor container
218
219
220       --log-dir=""
221           If non-empty, write log files in this directory
222
223
224       --log-flush-frequency=5s
225           Maximum number of seconds between log flushes
226
227
228       --logtostderr=true
229           log to standard error instead of files
230
231
232       --machine-id-file="/etc/machine-id,/var/lib/dbus/machine-id"
233           Comma-separated list of files to  check  for  machine-id.  Use  the
234       first one that exists.
235
236
237       --match-server-version=false
238           Require server version to match client version
239
240
241       --mesos-agent="127.0.0.1:5051"
242           Mesos agent address
243
244
245       --mesos-agent-timeout=10s
246           Mesos agent timeout
247
248
249       -n, --namespace=""
250           If present, the namespace scope for this CLI request
251
252
253       --request-timeout="0"
254           The  length  of  time  to  wait before giving up on a single server
255       request. Non-zero values should contain a corresponding time unit (e.g.
256       1s, 2m, 3h). A value of zero means don't timeout requests.
257
258
259       -s, --server=""
260           The address and port of the Kubernetes API server
261
262
263       --stderrthreshold=2
264           logs at or above this threshold go to stderr
265
266
267       --storage-driver-buffer-duration=1m0s
268           Writes  in  the  storage driver will be buffered for this duration,
269       and committed to the non memory backends as a single transaction
270
271
272       --storage-driver-db="cadvisor"
273           database name
274
275
276       --storage-driver-host="localhost:8086"
277           database host:port
278
279
280       --storage-driver-password="root"
281           database password
282
283
284       --storage-driver-secure=false
285           use secure connection with database
286
287
288       --storage-driver-table="stats"
289           table name
290
291
292       --storage-driver-user="root"
293           database username
294
295
296       --token=""
297           Bearer token for authentication to the API server
298
299
300       --user=""
301           The name of the kubeconfig user to use
302
303
304       -v, --v=0
305           log level for V logs
306
307
308       --version=false
309           Print version information and quit
310
311
312       --vmodule=
313           comma-separated list of pattern=N settings for  file-filtered  log‐
314       ging
315
316
317

EXAMPLE

319                # Watch the rollout status of a deployment
320                kubectl rollout status deployment/nginx
321
322
323
324

SEE ALSO

326       kubectl-rollout(1),
327
328
329

HISTORY

331       January  2015,  Originally compiled by Eric Paris (eparis at redhat dot
332       com) based on the kubernetes source material, but hopefully  they  have
333       been automatically generated since!
334
335
336
337Eric Paris                  kubernetes User Manuals              KUBERNETES(1)
Impressum