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

EXAMPLE

334                # Watch the rollout status of a deployment
335                kubectl rollout status deployment/nginx
336
337
338
339

SEE ALSO

341       kubectl-rollout(1),
342
343
344

HISTORY

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