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

NAME

6       kubectl  create  poddisruptionbudget  -  Create a pod disruption budget
7       with the specified name.
8
9
10

SYNOPSIS

12       kubectl create poddisruptionbudget [OPTIONS]
13
14
15

DESCRIPTION

17       Create a pod disruption budget with the specified name,  selector,  and
18       desired minimum available pods
19
20
21

OPTIONS

23       --allow-missing-template-keys=true
24           If  true, ignore any errors in templates when a field or map key is
25       missing in the template. Only applies to  golang  and  jsonpath  output
26       formats.
27
28
29       --dry-run=false
30           If  true, only print the object that would be sent, without sending
31       it.
32
33
34       --generator="poddisruptionbudget/v1beta1/v2"
35           The name of the API generator to use.
36
37
38       --max-unavailable=""
39           The maximum number or percentage of unavailable  pods  this  budget
40       requires.
41
42
43       --min-available=""
44           The  minimum  number  or  percentage  of available pods this budget
45       requires.
46
47
48       -o, --output=""
49           Output   format.   One    of:    json|yaml|name|go-template|go-tem‐
50       plate-file|templatefile|template|jsonpath|jsonpath-file.
51
52
53       --save-config=false
54           If  true,  the configuration of current object will be saved in its
55       annotation. Otherwise, the annotation will be unchanged. This  flag  is
56       useful  when  you  want  to perform kubectl apply on this object in the
57       future.
58
59
60       --selector=""
61           A label selector to use for this budget. Only equality-based selec‐
62       tor requirements are supported.
63
64
65       --template=""
66           Template  string  or  path  to template file to use when -o=go-tem‐
67       plate, -o=go-template-file. The template format is golang  templates  [
68http://golang.org/pkg/text/template/#pkg-overview⟩].
69
70
71       --validate=true
72           If true, use a schema to validate the input before sending it
73
74
75

OPTIONS INHERITED FROM PARENT COMMANDS

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

EXAMPLE

338                # Create a pod disruption budget named my-pdb that will select all pods with the app=rails label
339                # and require at least one of them being available at any point in time.
340                kubectl create poddisruptionbudget my-pdb --selector=app=rails --min-available=1
341
342                # Create a pod disruption budget named my-pdb that will select all pods with the app=nginx label
343                # and require at least half of the pods selected to be available at any point in time.
344                kubectl create pdb my-pdb --selector=app=nginx --min-available=50%
345
346
347
348

SEE ALSO

350       kubectl-create(1),
351
352
353

HISTORY

355       January  2015,  Originally compiled by Eric Paris (eparis at redhat dot
356       com) based on the kubernetes source material, but hopefully  they  have
357       been automatically generated since!
358
359
360
361Eric Paris                  kubernetes User Manuals              KUBERNETES(1)
Impressum