1OC(1) June 2016 OC(1)
2
6 oc apply - Apply a configuration to a resource by filename or stdin
7
11 oc apply [OPTIONS]
12
16 Apply a configuration to a resource by filename or stdin.
17 JSON and YAML formats are accepted.
20
24 --all=false
25 Select all resources in the namespace of the specified resource
26 types.
27 --allow-missing-template-keys=true
30 If true, ignore any errors in templates when a field or map key is
31 missing in the template. Only applies to golang and jsonpath output
32 formats.
33 --cascade=true
36 If true, cascade the deletion of the resources managed by this re‐
37 source (e.g. Pods created by a ReplicationController). Default true.
38 --dry-run=false
41 If true, only print the object that would be sent, without sending
42 it.
43 -f, --filename=[]
46 that contains the configuration to apply
47 --force=false
50 Only used when grace-period=0. If true, immediately remove re‐
51 sources from API and bypass graceful deletion. Note that immediate
52 deletion of some resources may result in inconsistency or data loss and
53 requires confirmation.
54 --grace-period=-1
57 Period of time in seconds given to the resource to terminate grace‐
58 fully. Ignored if negative. Set to 1 for immediate shutdown. Can only
59 be set to 0 when --force is true (force deletion).
60 --include-uninitialized=false
63 If true, the kubectl command applies to uninitialized objects. If
64 explicitly set to false, this flag overrides other flags that make the
65 kubectl commands apply to uninitialized objects, e.g., "--all". Objects
66 with empty metadata.initializers are regarded as initialized.
67 --openapi-patch=true
70 If true, use openapi to calculate diff when the openapi presents
71 and the resource can be found in the openapi spec. Otherwise, fall back
72 to use baked-in types.
73 -o, --output=""
76 Output format. One of: json|yaml|name|go-template-file|template‐
77 file|template|go-template|jsonpath|jsonpath-file.
78 --overwrite=true
81 Automatically resolve conflicts between the modified and live con‐
82 figuration by using values from the modified configuration
83 --prune=false
86 Automatically delete resource objects, including the uninitialized
87 ones, that do not appear in the configs and are created by either apply
88 or create --save-config. Should be used with either -l or --all.
89 --prune-whitelist=[]
92 Overwrite the default whitelist with <group/version/kind> for
93 --prune
94 --record=false
97 Record current kubectl command in the resource annotation. If set
98 to false, do not record the command. If set to true, record the com‐
99 mand. If not set, default to updating the existing annotation value
100 only if one already exists.
101 -R, --recursive=false
104 Process the directory used in -f, --filename recursively. Useful
105 when you want to manage related manifests organized within the same di‐
106 rectory.
107 -l, --selector=""
110 Selector (label query) to filter on, supports '=', '==', and
111 '!='.(e.g. -l key1=value1,key2=value2)
112 --template=""
115 Template string or path to template file to use when -o=go-tem‐
116 plate, -o=go-template-file. The template format is golang templates [
117 ⟨http://golang.org/pkg/text/template/#pkg-overview⟩].
118 --timeout=0
121 The length of time to wait before giving up on a delete, zero means
122 determine a timeout from the size of the object
123 --validate=false
126 If true, use a schema to validate the input before sending it
127 --wait=false
130 If true, wait for resources to be gone before returning. This waits
131 for finalizers.
132
136 --allow_verification_with_non_compliant_keys=false
137 Allow a SignatureVerifier to use keys which are technically
138 non-compliant with RFC6962.
139 --alsologtostderr=false
142 log to standard error as well as files
143 --application_metrics_count_limit=100
146 Max number of application metrics to store (per container)
147 --as=""
150 Username to impersonate for the operation
151 --as-group=[]
154 Group to impersonate for the operation, this flag can be repeated
155 to specify multiple groups.
156 --azure-container-registry-config=""
159 Path to the file containing Azure container registry configuration
160 information.
161 --boot_id_file="/proc/sys/kernel/random/boot_id"
164 Comma-separated list of files to check for boot-id. Use the first
165 one that exists.
166 --cache-dir="/builddir/.kube/http-cache"
169 Default HTTP cache directory
170 --certificate-authority=""
173 Path to a cert file for the certificate authority
174 --client-certificate=""
177 Path to a client certificate file for TLS
178 --client-key=""
181 Path to a client key file for TLS
182 --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
185 CIDRs opened in GCE firewall for LB traffic proxy health checks
186 --cluster=""
189 The name of the kubeconfig cluster to use
190 --container_hints="/etc/cadvisor/container_hints.json"
193 location of the container hints file
194 --containerd="unix:///var/run/containerd.sock"
197 containerd endpoint
198 --context=""
201 The name of the kubeconfig context to use
202 --default-not-ready-toleration-seconds=300
205 Indicates the tolerationSeconds of the toleration for
206 notReady:NoExecute that is added by default to every pod that does not
207 already have such a toleration.
208 --default-unreachable-toleration-seconds=300
211 Indicates the tolerationSeconds of the toleration for unreach‐
212 able:NoExecute that is added by default to every pod that does not al‐
213 ready have such a toleration.
214 --docker="unix:///var/run/docker.sock"
217 docker endpoint
218 --docker-tls=false
221 use TLS to connect to docker
222 --docker-tls-ca="ca.pem"
225 path to trusted CA
226 --docker-tls-cert="cert.pem"
229 path to client certificate
230 --docker-tls-key="key.pem"
233 path to private key
234 --docker_env_metadata_whitelist=""
237 a comma-separated list of environment variable keys that needs to
238 be collected for docker containers
239 --docker_only=false
242 Only report docker containers in addition to root stats
243 --docker_root="/var/lib/docker"
246 DEPRECATED: docker root is read from docker info (this is a fall‐
247 back, default: /var/lib/docker)
248 --enable_load_reader=false
251 Whether to enable cpu load reader
252 --event_storage_age_limit="default=24h"
255 Max length of time for which to store events (per type). Value is a
256 comma separated list of key values, where the keys are event types
257 (e.g.: creation, oom) or "default" and the value is a duration. Default
258 is applied to all non-specified event types
259 --event_storage_event_limit="default=100000"
262 Max number of events to store (per type). Value is a comma sepa‐
263 rated list of key values, where the keys are event types (e.g.: cre‐
264 ation, oom) or "default" and the value is an integer. Default is ap‐
265 plied to all non-specified event types
266 --global_housekeeping_interval=0
269 Interval between global housekeepings
270 --housekeeping_interval=0
273 Interval between container housekeepings
274 --insecure-skip-tls-verify=false
277 If true, the server's certificate will not be checked for validity.
278 This will make your HTTPS connections insecure
279 --kubeconfig=""
282 Path to the kubeconfig file to use for CLI requests.
283 --log-flush-frequency=0
286 Maximum number of seconds between log flushes
287 --log_backtrace_at=:0
290 when logging hits line file:N, emit a stack trace
291 --log_cadvisor_usage=false
294 Whether to log the usage of the cAdvisor container
295 --log_dir=""
298 If non-empty, write log files in this directory
299 --logtostderr=true
302 log to standard error instead of files
303 --machine_id_file="/etc/machine-id,/var/lib/dbus/machine-id"
306 Comma-separated list of files to check for machine-id. Use the
307 first one that exists.
308 --match-server-version=false
311 Require server version to match client version
312 -n, --namespace=""
315 If present, the namespace scope for this CLI request
316 --request-timeout="0"
319 The length of time to wait before giving up on a single server re‐
320 quest. Non-zero values should contain a corresponding time unit (e.g.
321 1s, 2m, 3h). A value of zero means don't timeout requests.
322 -s, --server=""
325 The address and port of the Kubernetes API server
326 --stderrthreshold=2
329 logs at or above this threshold go to stderr
330 --storage_driver_buffer_duration=0
333 Writes in the storage driver will be buffered for this duration,
334 and committed to the non memory backends as a single transaction
335 --storage_driver_db="cadvisor"
338 database name
339 --storage_driver_host="localhost:8086"
342 database host:port
343 --storage_driver_password="root"
346 database password
347 --storage_driver_secure=false
350 use secure connection with database
351 --storage_driver_table="stats"
354 table name
355 --storage_driver_user="root"
358 database username
359 --token=""
362 Bearer token for authentication to the API server
363 --user=""
366 The name of the kubeconfig user to use
367 -v, --v=0
370 log level for V logs
371 --version=false
374 Print version information and quit
375 --vmodule=
378 comma-separated list of pattern=N settings for file-filtered log‐
379 ging
380
384 # Apply the configuration in pod.json to a pod.
385 oc apply -f ./pod.json
386 # Apply the JSON passed into stdin to a pod.
388 cat pod.json | oc apply -f -
389
394 oc(1), oc-apply-edit-last-applied(1), oc-apply-set-last-applied(1),
395 oc-apply-view-last-applied(1),
396
400 June 2016, Ported from the Kubernetes man-doc generator
401Openshift Openshift CLI User Manuals OC(1)