1KUBERNETES(1)(kubernetes) KUBERNETES(1)(kubernetes)
2
3
4
5Eric Paris Jan 2015
6
7
9 kubectl create cronjob - Create a cronjob with the specified name.
10
11
12
14 kubectl create cronjob [OPTIONS]
15
16
17
19 Create a cronjob with the specified name.
20
21
22
24 --allow-missing-template-keys=true If true, ignore any errors in
25 templates when a field or map key is missing in the template. Only ap‐
26 plies to golang and jsonpath output formats.
27
28
29 --dry-run="none" Must be "none", "server", or "client". If client
30 strategy, only print the object that would be sent, without sending it.
31 If server strategy, submit server-side request without persisting the
32 resource.
33
34
35 --field-manager="kubectl-create" Name of the manager used to track
36 field ownership.
37
38
39 --image="" Image name to run.
40
41
42 -o, --output="" Output format. One of: json|yaml|name|go-tem‐
43 plate|go-template-file|template|templatefile|jsonpath|json‐
44 path-as-json|jsonpath-file.
45
46
47 --restart="" job's restart policy. supported values: OnFailure,
48 Never
49
50
51 --save-config=false If true, the configuration of current object
52 will be saved in its annotation. Otherwise, the annotation will be un‐
53 changed. This flag is useful when you want to perform kubectl apply on
54 this object in the future.
55
56
57 --schedule="" A schedule in the Cron format the job should be run
58 with.
59
60
61 --show-managed-fields=false If true, keep the managedFields when
62 printing objects in JSON or YAML format.
63
64
65 --template="" Template string or path to template file to use when
66 -o=go-template, -o=go-template-file. The template format is golang tem‐
67 plates [http://golang.org/pkg/text/template/#pkg-overview].
68
69
70 --validate=true If true, use a schema to validate the input before
71 sending it
72
73
74
76 --add-dir-header=false If true, adds the file directory to the
77 header of the log messages
78
79
80 --alsologtostderr=false log to standard error as well as files
81
82
83 --application-metrics-count-limit=100 Max number of application
84 metrics to store (per container)
85
86
87 --as="" Username to impersonate for the operation
88
89
90 --as-group=[] Group to impersonate for the operation, this flag
91 can be repeated to specify multiple groups.
92
93
94 --azure-container-registry-config="" Path to the file containing
95 Azure container registry configuration information.
96
97
98 --boot-id-file="/proc/sys/kernel/random/boot_id" Comma-separated
99 list of files to check for boot-id. Use the first one that exists.
100
101
102 --cache-dir="/builddir/.kube/cache" Default cache directory
103
104
105 --certificate-authority="" Path to a cert file for the certificate
106 authority
107
108
109 --client-certificate="" Path to a client certificate file for TLS
110
111
112 --client-key="" Path to a client key file for TLS
113
114
115 --cloud-provider-gce-l7lb-src-cidrs=130.211.0.0/22,35.191.0.0/16
116 CIDRs opened in GCE firewall for L7 LB traffic proxy health
117 checks
118
119
120 --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
121 CIDRs opened in GCE firewall for L4 LB traffic proxy health
122 checks
123
124
125 --cluster="" The name of the kubeconfig cluster to use
126
127
128 --container-hints="/etc/cadvisor/container_hints.json" location of
129 the container hints file
130
131
132 --containerd="/run/containerd/containerd.sock" containerd endpoint
133
134
135 --containerd-namespace="k8s.io" containerd namespace
136
137
138 --context="" The name of the kubeconfig context to use
139
140
141 --default-not-ready-toleration-seconds=300 Indicates the tolera‐
142 tionSeconds of the toleration for notReady:NoExecute that is added by
143 default to every pod that does not already have such a toleration.
144
145
146 --default-unreachable-toleration-seconds=300 Indicates the tolera‐
147 tionSeconds of the toleration for unreachable:NoExecute that is added
148 by default to every pod that does not already have such a toleration.
149
150
151 --disable-root-cgroup-stats=false Disable collecting root Cgroup
152 stats
153
154
155 --docker="unix:///var/run/docker.sock" docker endpoint
156
157
158 --docker-env-metadata-whitelist="" a comma-separated list of envi‐
159 ronment variable keys matched with specified prefix that needs to be
160 collected for docker containers
161
162
163 --docker-only=false Only report docker containers in addition to
164 root stats
165
166
167 --docker-root="/var/lib/docker" DEPRECATED: docker root is read
168 from docker info (this is a fallback, default: /var/lib/docker)
169
170
171 --docker-tls=false use TLS to connect to docker
172
173
174 --docker-tls-ca="ca.pem" path to trusted CA
175
176
177 --docker-tls-cert="cert.pem" path to client certificate
178
179
180 --docker-tls-key="key.pem" path to private key
181
182
183 --enable-load-reader=false Whether to enable cpu load reader
184
185
186 --event-storage-age-limit="default=0" Max length of time for which
187 to store events (per type). Value is a comma separated list of key val‐
188 ues, where the keys are event types (e.g.: creation, oom) or "default"
189 and the value is a duration. Default is applied to all non-specified
190 event types
191
192
193 --event-storage-event-limit="default=0" Max number of events to
194 store (per type). Value is a comma separated list of key values, where
195 the keys are event types (e.g.: creation, oom) or "default" and the
196 value is an integer. Default is applied to all non-specified event
197 types
198
199
200 --global-housekeeping-interval=1m0s Interval between global house‐
201 keepings
202
203
204 --housekeeping-interval=10s Interval between container housekeep‐
205 ings
206
207
208 --insecure-skip-tls-verify=false If true, the server's certificate
209 will not be checked for validity. This will make your HTTPS connections
210 insecure
211
212
213 --kubeconfig="" Path to the kubeconfig file to use for CLI re‐
214 quests.
215
216
217 --log-backtrace-at=:0 when logging hits line file:N, emit a stack
218 trace
219
220
221 --log-cadvisor-usage=false Whether to log the usage of the cAdvi‐
222 sor container
223
224
225 --log-dir="" If non-empty, write log files in this directory
226
227
228 --log-file="" If non-empty, use this log file
229
230
231 --log-file-max-size=1800 Defines the maximum size a log file can
232 grow to. Unit is megabytes. If the value is 0, the maximum file size is
233 unlimited.
234
235
236 --log-flush-frequency=5s Maximum number of seconds between log
237 flushes
238
239
240 --logtostderr=true log to standard error instead of files
241
242
243 --machine-id-file="/etc/machine-id,/var/lib/dbus/machine-id"
244 Comma-separated list of files to check for machine-id. Use the
245 first one that exists.
246
247
248 --match-server-version=false Require server version to match
249 client version
250
251
252 -n, --namespace="" If present, the namespace scope for this CLI
253 request
254
255
256 --one-output=false If true, only write logs to their native sever‐
257 ity level (vs also writing to each lower severity level)
258
259
260 --password="" Password for basic authentication to the API server
261
262
263 --profile="none" Name of profile to capture. One of
264 (none|cpu|heap|goroutine|threadcreate|block|mutex)
265
266
267 --profile-output="profile.pprof" Name of the file to write the
268 profile to
269
270
271 --referenced-reset-interval=0 Reset interval for referenced bytes
272 (container_referenced_bytes metric), number of measurement cycles after
273 which referenced bytes are cleared, if set to 0 referenced bytes are
274 never cleared (default: 0)
275
276
277 --request-timeout="0" The length of time to wait before giving up
278 on a single server request. Non-zero values should contain a corre‐
279 sponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't time‐
280 out requests.
281
282
283 -s, --server="" The address and port of the Kubernetes API server
284
285
286 --skip-headers=false If true, avoid header prefixes in the log
287 messages
288
289
290 --skip-log-headers=false If true, avoid headers when opening log
291 files
292
293
294 --stderrthreshold=2 logs at or above this threshold go to stderr
295
296
297 --storage-driver-buffer-duration=1m0s Writes in the storage driver
298 will be buffered for this duration, and committed to the non memory
299 backends as a single transaction
300
301
302 --storage-driver-db="cadvisor" database name
303
304
305 --storage-driver-host="localhost:8086" database host:port
306
307
308 --storage-driver-password="root" database password
309
310
311 --storage-driver-secure=false use secure connection with database
312
313
314 --storage-driver-table="stats" table name
315
316
317 --storage-driver-user="root" database username
318
319
320 --tls-server-name="" Server name to use for server certificate
321 validation. If it is not provided, the hostname used to contact the
322 server is used
323
324
325 --token="" Bearer token for authentication to the API server
326
327
328 --update-machine-info-interval=5m0s Interval between machine info
329 updates.
330
331
332 --user="" The name of the kubeconfig user to use
333
334
335 --username="" Username for basic authentication to the API server
336
337
338 -v, --v=0 number for the log level verbosity
339
340
341 --version=false Print version information and quit
342
343
344 --vmodule= comma-separated list of pattern=N settings for
345 file-filtered logging
346
347
348 --warnings-as-errors=false Treat warnings received from the server
349 as errors and exit with a non-zero exit code
350
351
352
354 # Create a cronjob
355 kubectl create cronjob my-job --image=busybox --schedule="*/1 * * * *"
356
357 # Create a cronjob with command
358 kubectl create cronjob my-job --image=busybox --schedule="*/1 * * * *" -- date
359
360
361
362
364 kubectl-create(1),
365
366
367
369 January 2015, Originally compiled by Eric Paris (eparis at redhat dot
370 com) based on the kubernetes source material, but hopefully they have
371 been automatically generated since!
372
373
374
375Manuals User KUBERNETES(1)(kubernetes)