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