1KUBERNETES(1)(kubernetes) KUBERNETES(1)(kubernetes)
2Eric Paris Jan 2015
6
9 kubectl replace - Replace a resource by filename or stdin
10
14 kubectl replace [OPTIONS]
15
19 Replace a resource by filename or stdin.
20 JSON and YAML formats are accepted. If replacing an existing resource,
23 the complete resource spec must be provided. This can be obtained by
24 $ kubectl get TYPE NAME -o yaml
27
31 --allow-missing-template-keys=true If true, ignore any errors in
32 templates when a field or map key is missing in the template. Only ap‐
33 plies to golang and jsonpath output formats.
34 --cascade="background" Must be "background", "orphan", or "fore‐
37 ground". Selects the deletion cascading strategy for the dependents
38 (e.g. Pods created by a ReplicationController). Defaults to background.
39 --dry-run="none" Must be "none", "server", or "client". If client
42 strategy, only print the object that would be sent, without sending it.
43 If server strategy, submit server-side request without persisting the
44 resource.
45 --field-manager="kubectl-replace" Name of the manager used to
48 track field ownership.
49 -f, --filename=[] to use to replace the resource.
52 --force=false If true, immediately remove resources from API and
55 bypass graceful deletion. Note that immediate deletion of some re‐
56 sources may result in inconsistency or data loss and requires confirma‐
57 tion.
58 --grace-period=-1 Period of time in seconds given to the resource
61 to terminate gracefully. Ignored if negative. Set to 1 for immediate
62 shutdown. Can only be set to 0 when --force is true (force deletion).
63 -k, --kustomize="" Process a kustomization directory. This flag
66 can't be used together with -f or -R.
67 -o, --output="" Output format. One of: json|yaml|name|go-tem‐
70 plate|go-template-file|template|templatefile|jsonpath|json‐
71 path-as-json|jsonpath-file.
72 --raw="" Raw URI to PUT to the server. Uses the transport speci‐
75 fied by the kubeconfig file.
76 -R, --recursive=false Process the directory used in -f, --filename
79 recursively. Useful when you want to manage related manifests organized
80 within the same directory.
81 --save-config=false If true, the configuration of current object
84 will be saved in its annotation. Otherwise, the annotation will be un‐
85 changed. This flag is useful when you want to perform kubectl apply on
86 this object in the future.
87 --show-managed-fields=false If true, keep the managedFields when
90 printing objects in JSON or YAML format.
91 --template="" Template string or path to template file to use when
94 -o=go-template, -o=go-template-file. The template format is golang tem‐
95 plates [http://golang.org/pkg/text/template/#pkg-overview].
96 --timeout=0s The length of time to wait before giving up on a
99 delete, zero means determine a timeout from the size of the object
100 --validate=true If true, use a schema to validate the input before
103 sending it
104 --wait=false If true, wait for resources to be gone before return‐
107 ing. This waits for finalizers.
108
112 --add-dir-header=false If true, adds the file directory to the
113 header of the log messages
114 --alsologtostderr=false log to standard error as well as files
117 --application-metrics-count-limit=100 Max number of application
120 metrics to store (per container)
121 --as="" Username to impersonate for the operation
124 --as-group=[] Group to impersonate for the operation, this flag
127 can be repeated to specify multiple groups.
128 --azure-container-registry-config="" Path to the file containing
131 Azure container registry configuration information.
132 --boot-id-file="/proc/sys/kernel/random/boot_id" Comma-separated
135 list of files to check for boot-id. Use the first one that exists.
136 --cache-dir="/builddir/.kube/cache" Default cache directory
139 --certificate-authority="" Path to a cert file for the certificate
142 authority
143 --client-certificate="" Path to a client certificate file for TLS
146 --client-key="" Path to a client key file for TLS
149 --cloud-provider-gce-l7lb-src-cidrs=130.211.0.0/22,35.191.0.0/16
152 CIDRs opened in GCE firewall for L7 LB traffic proxy health
153 checks
154 --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
157 CIDRs opened in GCE firewall for L4 LB traffic proxy health
158 checks
159 --cluster="" The name of the kubeconfig cluster to use
162 --container-hints="/etc/cadvisor/container_hints.json" location of
165 the container hints file
166 --containerd="/run/containerd/containerd.sock" containerd endpoint
169 --containerd-namespace="k8s.io" containerd namespace
172 --context="" The name of the kubeconfig context to use
175 --default-not-ready-toleration-seconds=300 Indicates the tolera‐
178 tionSeconds of the toleration for notReady:NoExecute that is added by
179 default to every pod that does not already have such a toleration.
180 --default-unreachable-toleration-seconds=300 Indicates the tolera‐
183 tionSeconds of the toleration for unreachable:NoExecute that is added
184 by default to every pod that does not already have such a toleration.
185 --disable-root-cgroup-stats=false Disable collecting root Cgroup
188 stats
189 --docker="unix:///var/run/docker.sock" docker endpoint
192 --docker-env-metadata-whitelist="" a comma-separated list of envi‐
195 ronment variable keys matched with specified prefix that needs to be
196 collected for docker containers
197 --docker-only=false Only report docker containers in addition to
200 root stats
201 --docker-root="/var/lib/docker" DEPRECATED: docker root is read
204 from docker info (this is a fallback, default: /var/lib/docker)
205 --docker-tls=false use TLS to connect to docker
208 --docker-tls-ca="ca.pem" path to trusted CA
211 --docker-tls-cert="cert.pem" path to client certificate
214 --docker-tls-key="key.pem" path to private key
217 --enable-load-reader=false Whether to enable cpu load reader
220 --event-storage-age-limit="default=0" Max length of time for which
223 to store events (per type). Value is a comma separated list of key val‐
224 ues, where the keys are event types (e.g.: creation, oom) or "default"
225 and the value is a duration. Default is applied to all non-specified
226 event types
227 --event-storage-event-limit="default=0" Max number of events to
230 store (per type). Value is a comma separated list of key values, where
231 the keys are event types (e.g.: creation, oom) or "default" and the
232 value is an integer. Default is applied to all non-specified event
233 types
234 --global-housekeeping-interval=1m0s Interval between global house‐
237 keepings
238 --housekeeping-interval=10s Interval between container housekeep‐
241 ings
242 --insecure-skip-tls-verify=false If true, the server's certificate
245 will not be checked for validity. This will make your HTTPS connections
246 insecure
247 --kubeconfig="" Path to the kubeconfig file to use for CLI re‐
250 quests.
251 --log-backtrace-at=:0 when logging hits line file:N, emit a stack
254 trace
255 --log-cadvisor-usage=false Whether to log the usage of the cAdvi‐
258 sor container
259 --log-dir="" If non-empty, write log files in this directory
262 --log-file="" If non-empty, use this log file
265 --log-file-max-size=1800 Defines the maximum size a log file can
268 grow to. Unit is megabytes. If the value is 0, the maximum file size is
269 unlimited.
270 --log-flush-frequency=5s Maximum number of seconds between log
273 flushes
274 --logtostderr=true log to standard error instead of files
277 --machine-id-file="/etc/machine-id,/var/lib/dbus/machine-id"
280 Comma-separated list of files to check for machine-id. Use the
281 first one that exists.
282 --match-server-version=false Require server version to match
285 client version
286 -n, --namespace="" If present, the namespace scope for this CLI
289 request
290 --one-output=false If true, only write logs to their native sever‐
293 ity level (vs also writing to each lower severity level)
294 --password="" Password for basic authentication to the API server
297 --profile="none" Name of profile to capture. One of
300 (none|cpu|heap|goroutine|threadcreate|block|mutex)
301 --profile-output="profile.pprof" Name of the file to write the
304 profile to
305 --referenced-reset-interval=0 Reset interval for referenced bytes
308 (container_referenced_bytes metric), number of measurement cycles after
309 which referenced bytes are cleared, if set to 0 referenced bytes are
310 never cleared (default: 0)
311 --request-timeout="0" The length of time to wait before giving up
314 on a single server request. Non-zero values should contain a corre‐
315 sponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't time‐
316 out requests.
317 -s, --server="" The address and port of the Kubernetes API server
320 --skip-headers=false If true, avoid header prefixes in the log
323 messages
324 --skip-log-headers=false If true, avoid headers when opening log
327 files
328 --stderrthreshold=2 logs at or above this threshold go to stderr
331 --storage-driver-buffer-duration=1m0s Writes in the storage driver
334 will be buffered for this duration, and committed to the non memory
335 backends as a single transaction
336 --storage-driver-db="cadvisor" database name
339 --storage-driver-host="localhost:8086" database host:port
342 --storage-driver-password="root" database password
345 --storage-driver-secure=false use secure connection with database
348 --storage-driver-table="stats" table name
351 --storage-driver-user="root" database username
354 --tls-server-name="" Server name to use for server certificate
357 validation. If it is not provided, the hostname used to contact the
358 server is used
359 --token="" Bearer token for authentication to the API server
362 --update-machine-info-interval=5m0s Interval between machine info
365 updates.
366 --user="" The name of the kubeconfig user to use
369 --username="" Username for basic authentication to the API server
372 -v, --v=0 number for the log level verbosity
375 --version=false Print version information and quit
378 --vmodule= comma-separated list of pattern=N settings for
381 file-filtered logging
382 --warnings-as-errors=false Treat warnings received from the server
385 as errors and exit with a non-zero exit code
386
390 # Replace a pod using the data in pod.json.
391 kubectl replace -f ./pod.json
392 # Replace a pod based on the JSON passed into stdin.
394 cat pod.json | kubectl replace -f -
395 # Update a single-container pod's image version (tag) to v4
397 kubectl get pod mypod -o yaml | sed 's/\(image: myimage\):.*$/\1:v4/' | kubectl replace -f -
398 # Force replace, delete and then re-create the resource
400 kubectl replace --force -f ./pod.json
401
406 kubectl(1),
407
411 January 2015, Originally compiled by Eric Paris (eparis at redhat dot
412 com) based on the kubernetes source material, but hopefully they have
413 been automatically generated since!
414Manuals User KUBERNETES(1)(kubernetes)