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 --show-managed-fields=false If true, keep the managedFields when
53 printing objects in JSON or YAML format.
54 --template="" Template string or path to template file to use when
57 -o=go-template, -o=go-template-file. The template format is golang tem‐
58 plates [http://golang.org/pkg/text/template/#pkg-overview].
59
63 --add-dir-header=false If true, adds the file directory to the
64 header of the log messages
65 --alsologtostderr=false log to standard error as well as files
68 --application-metrics-count-limit=100 Max number of application
71 metrics to store (per container)
72 --as="" Username to impersonate for the operation
75 --as-group=[] Group to impersonate for the operation, this flag
78 can be repeated to specify multiple groups.
79 --azure-container-registry-config="" Path to the file containing
82 Azure container registry configuration information.
83 --boot-id-file="/proc/sys/kernel/random/boot_id" Comma-separated
86 list of files to check for boot-id. Use the first one that exists.
87 --cache-dir="/builddir/.kube/cache" Default cache directory
90 --certificate-authority="" Path to a cert file for the certificate
93 authority
94 --client-certificate="" Path to a client certificate file for TLS
97 --client-key="" Path to a client key file for TLS
100 --cloud-provider-gce-l7lb-src-cidrs=130.211.0.0/22,35.191.0.0/16
103 CIDRs opened in GCE firewall for L7 LB traffic proxy health
104 checks
105 --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
108 CIDRs opened in GCE firewall for L4 LB traffic proxy health
109 checks
110 --cluster="" The name of the kubeconfig cluster to use
113 --container-hints="/etc/cadvisor/container_hints.json" location of
116 the container hints file
117 --containerd="/run/containerd/containerd.sock" containerd endpoint
120 --containerd-namespace="k8s.io" containerd namespace
123 --context="" The name of the kubeconfig context to use
126 --default-not-ready-toleration-seconds=300 Indicates the tolera‐
129 tionSeconds of the toleration for notReady:NoExecute that is added by
130 default to every pod that does not already have such a toleration.
131 --default-unreachable-toleration-seconds=300 Indicates the tolera‐
134 tionSeconds of the toleration for unreachable:NoExecute that is added
135 by default to every pod that does not already have such a toleration.
136 --disable-root-cgroup-stats=false Disable collecting root Cgroup
139 stats
140 --docker="unix:///var/run/docker.sock" docker endpoint
143 --docker-env-metadata-whitelist="" a comma-separated list of envi‐
146 ronment variable keys matched with specified prefix that needs to be
147 collected for docker containers
148 --docker-only=false Only report docker containers in addition to
151 root stats
152 --docker-root="/var/lib/docker" DEPRECATED: docker root is read
155 from docker info (this is a fallback, default: /var/lib/docker)
156 --docker-tls=false use TLS to connect to docker
159 --docker-tls-ca="ca.pem" path to trusted CA
162 --docker-tls-cert="cert.pem" path to client certificate
165 --docker-tls-key="key.pem" path to private key
168 --enable-load-reader=false Whether to enable cpu load reader
171 --event-storage-age-limit="default=0" Max length of time for which
174 to store events (per type). Value is a comma separated list of key val‐
175 ues, where the keys are event types (e.g.: creation, oom) or "default"
176 and the value is a duration. Default is applied to all non-specified
177 event types
178 --event-storage-event-limit="default=0" Max number of events to
181 store (per type). Value is a comma separated list of key values, where
182 the keys are event types (e.g.: creation, oom) or "default" and the
183 value is an integer. Default is applied to all non-specified event
184 types
185 --global-housekeeping-interval=1m0s Interval between global house‐
188 keepings
189 --housekeeping-interval=10s Interval between container housekeep‐
192 ings
193 --insecure-skip-tls-verify=false If true, the server's certificate
196 will not be checked for validity. This will make your HTTPS connections
197 insecure
198 --kubeconfig="" Path to the kubeconfig file to use for CLI re‐
201 quests.
202 --log-backtrace-at=:0 when logging hits line file:N, emit a stack
205 trace
206 --log-cadvisor-usage=false Whether to log the usage of the cAdvi‐
209 sor container
210 --log-dir="" If non-empty, write log files in this directory
213 --log-file="" If non-empty, use this log file
216 --log-file-max-size=1800 Defines the maximum size a log file can
219 grow to. Unit is megabytes. If the value is 0, the maximum file size is
220 unlimited.
221 --log-flush-frequency=5s Maximum number of seconds between log
224 flushes
225 --logtostderr=true log to standard error instead of files
228 --machine-id-file="/etc/machine-id,/var/lib/dbus/machine-id"
231 Comma-separated list of files to check for machine-id. Use the
232 first one that exists.
233 --match-server-version=false Require server version to match
236 client version
237 -n, --namespace="" If present, the namespace scope for this CLI
240 request
241 --one-output=false If true, only write logs to their native sever‐
244 ity level (vs also writing to each lower severity level)
245 --password="" Password for basic authentication to the API server
248 --profile="none" Name of profile to capture. One of
251 (none|cpu|heap|goroutine|threadcreate|block|mutex)
252 --profile-output="profile.pprof" Name of the file to write the
255 profile to
256 --referenced-reset-interval=0 Reset interval for referenced bytes
259 (container_referenced_bytes metric), number of measurement cycles after
260 which referenced bytes are cleared, if set to 0 referenced bytes are
261 never cleared (default: 0)
262 --request-timeout="0" The length of time to wait before giving up
265 on a single server request. Non-zero values should contain a corre‐
266 sponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't time‐
267 out requests.
268 -s, --server="" The address and port of the Kubernetes API server
271 --skip-headers=false If true, avoid header prefixes in the log
274 messages
275 --skip-log-headers=false If true, avoid headers when opening log
278 files
279 --stderrthreshold=2 logs at or above this threshold go to stderr
282 --storage-driver-buffer-duration=1m0s Writes in the storage driver
285 will be buffered for this duration, and committed to the non memory
286 backends as a single transaction
287 --storage-driver-db="cadvisor" database name
290 --storage-driver-host="localhost:8086" database host:port
293 --storage-driver-password="root" database password
296 --storage-driver-secure=false use secure connection with database
299 --storage-driver-table="stats" table name
302 --storage-driver-user="root" database username
305 --tls-server-name="" Server name to use for server certificate
308 validation. If it is not provided, the hostname used to contact the
309 server is used
310 --token="" Bearer token for authentication to the API server
313 --update-machine-info-interval=5m0s Interval between machine info
316 updates.
317 --user="" The name of the kubeconfig user to use
320 --username="" Username for basic authentication to the API server
323 -v, --v=0 number for the log level verbosity
326 --version=false Print version information and quit
329 --vmodule= comma-separated list of pattern=N settings for
332 file-filtered logging
333 --warnings-as-errors=false Treat warnings received from the server
336 as errors and exit with a non-zero exit code
337
341 # Set the last-applied-configuration of a resource to match the contents of a file.
342 kubectl apply set-last-applied -f deploy.yaml
343 # Execute set-last-applied against each configuration file in a directory.
345 kubectl apply set-last-applied -f path/
346 # 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.
348 kubectl apply set-last-applied -f deploy.yaml --create-annotation=true
349
354 kubectl-apply(1),
355
359 January 2015, Originally compiled by Eric Paris (eparis at redhat dot
360 com) based on the kubernetes source material, but hopefully they have
361 been automatically generated since!
362Manuals User KUBERNETES(1)(kubernetes)