1KUBERNETES(1)(kubernetes) KUBERNETES(1)(kubernetes)
2Eric Paris Jan 2015
6
9 kubectl apply set-last-applied - Set the last-applied-configuration an‐
10 notation on a live object to match the contents of a file.
11
15 kubectl apply set-last-applied [OPTIONS]
16
20 Set the latest last-applied-configuration annotations by setting it to
21 match the contents of a file. This results in the last-applied-configu‐
22 ration being updated as though 'kubectl apply -f ' was run, without up‐
23 dating any other parts of the object.
24
28 --allow-missing-template-keys=true If true, ignore any errors in
29 templates when a field or map key is missing in the template. Only ap‐
30 plies to golang and jsonpath output formats.
31 --create-annotation=false Will create 'last-applied-configuration'
34 annotations if current objects doesn't have one
35 --dry-run="none" Must be "none", "server", or "client". If client
38 strategy, only print the object that would be sent, without sending it.
39 If server strategy, submit server-side request without persisting the
40 resource.
41 -f, --filename=[] Filename, directory, or URL to files that con‐
44 tains the last-applied-configuration annotations
45 -o, --output="" Output format. One of: json|yaml|name|go-tem‐
48 plate|go-template-file|template|templatefile|jsonpath|json‐
49 path-as-json|jsonpath-file.
50 --template="" Template string or path to template file to use when
53 -o=go-template, -o=go-template-file. The template format is golang tem‐
54 plates [http://golang.org/pkg/text/template/#pkg-overview].
55
59 --add-dir-header=false If true, adds the file directory to the
60 header of the log messages
61 --alsologtostderr=false log to standard error as well as files
64 --application-metrics-count-limit=100 Max number of application
67 metrics to store (per container)
68 --as="" Username to impersonate for the operation
71 --as-group=[] Group to impersonate for the operation, this flag
74 can be repeated to specify multiple groups.
75 --azure-container-registry-config="" Path to the file containing
78 Azure container registry configuration information.
79 --boot-id-file="/proc/sys/kernel/random/boot_id" Comma-separated
82 list of files to check for boot-id. Use the first one that exists.
83 --cache-dir="/builddir/.kube/cache" Default cache directory
86 --certificate-authority="" Path to a cert file for the certificate
89 authority
90 --client-certificate="" Path to a client certificate file for TLS
93 --client-key="" Path to a client key file for TLS
96 --cloud-provider-gce-l7lb-src-cidrs=130.211.0.0/22,35.191.0.0/16
99 CIDRs opened in GCE firewall for L7 LB traffic proxy health
100 checks
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
104 CIDRs opened in GCE firewall for L4 LB traffic proxy health
105 checks
106 --cluster="" The name of the kubeconfig cluster to use
109 --container-hints="/etc/cadvisor/container_hints.json" location of
112 the container hints file
113 --containerd="/run/containerd/containerd.sock" containerd endpoint
116 --containerd-namespace="k8s.io" containerd namespace
119 --context="" The name of the kubeconfig context to use
122 --default-not-ready-toleration-seconds=300 Indicates the tolera‐
125 tionSeconds of the toleration for notReady:NoExecute that is added by
126 default to every pod that does not already have such a toleration.
127 --default-unreachable-toleration-seconds=300 Indicates the tolera‐
130 tionSeconds of the toleration for unreachable:NoExecute that is added
131 by default to every pod that does not already have such a toleration.
132 --disable-root-cgroup-stats=false Disable collecting root Cgroup
135 stats
136 --docker="unix:///var/run/docker.sock" docker endpoint
139 --docker-env-metadata-whitelist="" a comma-separated list of envi‐
142 ronment variable keys matched with specified prefix that needs to be
143 collected for docker containers
144 --docker-only=false Only report docker containers in addition to
147 root stats
148 --docker-root="/var/lib/docker" DEPRECATED: docker root is read
151 from docker info (this is a fallback, default: /var/lib/docker)
152 --docker-tls=false use TLS to connect to docker
155 --docker-tls-ca="ca.pem" path to trusted CA
158 --docker-tls-cert="cert.pem" path to client certificate
161 --docker-tls-key="key.pem" path to private key
164 --enable-load-reader=false Whether to enable cpu load reader
167 --event-storage-age-limit="default=0" Max length of time for which
170 to store events (per type). Value is a comma separated list of key val‐
171 ues, where the keys are event types (e.g.: creation, oom) or "default"
172 and the value is a duration. Default is applied to all non-specified
173 event types
174 --event-storage-event-limit="default=0" Max number of events to
177 store (per type). Value is a comma separated list of key values, where
178 the keys are event types (e.g.: creation, oom) or "default" and the
179 value is an integer. Default is applied to all non-specified event
180 types
181 --global-housekeeping-interval=1m0s Interval between global house‐
184 keepings
185 --housekeeping-interval=10s Interval between container housekeep‐
188 ings
189 --insecure-skip-tls-verify=false If true, the server's certificate
192 will not be checked for validity. This will make your HTTPS connections
193 insecure
194 --kubeconfig="" Path to the kubeconfig file to use for CLI re‐
197 quests.
198 --log-backtrace-at=:0 when logging hits line file:N, emit a stack
201 trace
202 --log-cadvisor-usage=false Whether to log the usage of the cAdvi‐
205 sor container
206 --log-dir="" If non-empty, write log files in this directory
209 --log-file="" If non-empty, use this log file
212 --log-file-max-size=1800 Defines the maximum size a log file can
215 grow to. Unit is megabytes. If the value is 0, the maximum file size is
216 unlimited.
217 --log-flush-frequency=5s Maximum number of seconds between log
220 flushes
221 --logtostderr=true log to standard error instead of files
224 --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 --match-server-version=false Require server version to match
232 client version
233 -n, --namespace="" If present, the namespace scope for this CLI
236 request
237 --one-output=false If true, only write logs to their native sever‐
240 ity level (vs also writing to each lower severity level
241 --password="" Password for basic authentication to the API server
244 --profile="none" Name of profile to capture. One of
247 (none|cpu|heap|goroutine|threadcreate|block|mutex)
248 --profile-output="profile.pprof" Name of the file to write the
251 profile to
252 --referenced-reset-interval=0 Reset interval for referenced bytes
255 (container_referenced_bytes metric), number of measurement cycles after
256 which referenced bytes are cleared, if set to 0 referenced bytes are
257 never cleared (default: 0)
258 --request-timeout="0" The length of time to wait before giving up
261 on a single server request. Non-zero values should contain a corre‐
262 sponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't time‐
263 out requests.
264 -s, --server="" The address and port of the Kubernetes API server
267 --skip-headers=false If true, avoid header prefixes in the log
270 messages
271 --skip-log-headers=false If true, avoid headers when opening log
274 files
275 --stderrthreshold=2 logs at or above this threshold go to stderr
278 --storage-driver-buffer-duration=1m0s Writes in the storage driver
281 will be buffered for this duration, and committed to the non memory
282 backends as a single transaction
283 --storage-driver-db="cadvisor" database name
286 --storage-driver-host="localhost:8086" database host:port
289 --storage-driver-password="root" database password
292 --storage-driver-secure=false use secure connection with database
295 --storage-driver-table="stats" table name
298 --storage-driver-user="root" database username
301 --tls-server-name="" Server name to use for server certificate
304 validation. If it is not provided, the hostname used to contact the
305 server is used
306 --token="" Bearer token for authentication to the API server
309 --update-machine-info-interval=5m0s Interval between machine info
312 updates.
313 --user="" The name of the kubeconfig user to use
316 --username="" Username for basic authentication to the API server
319 -v, --v=0 number for the log level verbosity
322 --version=false Print version information and quit
325 --vmodule= comma-separated list of pattern=N settings for
328 file-filtered logging
329 --warnings-as-errors=false Treat warnings received from the server
332 as errors and exit with a non-zero exit code
333
337 # Set the last-applied-configuration of a resource to match the contents of a file.
338 kubectl apply set-last-applied -f deploy.yaml
339 # Execute set-last-applied against each configuration file in a directory.
341 kubectl apply set-last-applied -f path/
342 # Set the last-applied-configuration of a resource to match the contents of a file, will create the annotation if it does not already exist.
344 kubectl apply set-last-applied -f deploy.yaml --create-annotation=true
345
350 kubectl-apply(1),
351
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!
358Manuals User KUBERNETES(1)(kubernetes)