1KUBERNETES(1) Jan 2015 KUBERNETES(1)
2
6 kubectl apply edit-last-applied - Edit latest last-applied-configura‐
7 tion annotations of a resource/object
8
12 kubectl apply edit-last-applied [OPTIONS]
13
17 Edit the latest last-applied-configuration annotations of resources
18 from the default editor.
19 The edit-last-applied command allows you to directly edit any API
22 resource you can retrieve via the command line tools. It will open the
23 editor defined by your KUBE_EDITOR, or EDITOR environment variables, or
24 fall back to 'vi' for Linux or 'notepad' for Windows. You can edit mul‐
25 tiple objects, although changes are applied one at a time. The command
26 accepts filenames as well as command line arguments, although the files
27 you point to must be previously saved versions of resources.
28 The default format is YAML. To edit in JSON, specify "-o json".
31 The flag --windows-line-endings can be used to force Windows line end‐
34 ings, otherwise the default for your operating system will be used.
35 In the event an error occurs while updating, a temporary file will be
38 created on disk that contains your unapplied changes. The most common
39 error when updating a resource is another editor changing the resource
40 on the server. When this occurs, you will have to apply your changes to
41 the newer version of the resource, or update your temporary saved copy
42 to include the latest resource version.
43
47 --allow-missing-template-keys=true
48 If true, ignore any errors in templates when a field or map key is
49 missing in the template. Only applies to golang and jsonpath output
50 formats.
51 -f, --filename=[]
54 Filename, directory, or URL to files to use to edit the resource
55 --include-uninitialized=false
58 If true, the kubectl command applies to uninitialized objects. If
59 explicitly set to false, this flag overrides other flags that make the
60 kubectl commands apply to uninitialized objects, e.g., "--all". Objects
61 with empty metadata.initializers are regarded as initialized.
62 -k, --kustomize=""
65 Process the kustomization directory. This flag can't be used
66 together with -f or -R.
67 -o, --output=""
70 Output format. One of: json|yaml|name|go-template|go-tem‐
71 plate-file|template|templatefile|jsonpath|jsonpath-file.
72 --record=false
75 Record current kubectl command in the resource annotation. If set
76 to false, do not record the command. If set to true, record the com‐
77 mand. If not set, default to updating the existing annotation value
78 only if one already exists.
79 -R, --recursive=false
82 Process the directory used in -f, --filename recursively. Useful
83 when you want to manage related manifests organized within the same
84 directory.
85 --template=""
88 Template string or path to template file to use when -o=go-tem‐
89 plate, -o=go-template-file. The template format is golang templates [
90 ⟨http://golang.org/pkg/text/template/#pkg-overview⟩].
91 --windows-line-endings=false
94 Defaults to the line ending native to your platform.
95
99 --alsologtostderr=false
100 log to standard error as well as files
101 --application-metrics-count-limit=100
104 Max number of application metrics to store (per container)
105 --as=""
108 Username to impersonate for the operation
109 --as-group=[]
112 Group to impersonate for the operation, this flag can be repeated
113 to specify multiple groups.
114 --azure-container-registry-config=""
117 Path to the file containing Azure container registry configuration
118 information.
119 --boot-id-file="/proc/sys/kernel/random/boot_id"
122 Comma-separated list of files to check for boot-id. Use the first
123 one that exists.
124 --cache-dir="/builddir/.kube/http-cache"
127 Default HTTP cache directory
128 --certificate-authority=""
131 Path to a cert file for the certificate authority
132 --client-certificate=""
135 Path to a client certificate file for TLS
136 --client-key=""
139 Path to a client key file for TLS
140 --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
143 CIDRs opened in GCE firewall for LB traffic proxy health checks
144 --cluster=""
147 The name of the kubeconfig cluster to use
148 --container-hints="/etc/cadvisor/container_hints.json"
151 location of the container hints file
152 --containerd="/run/containerd/containerd.sock"
155 containerd endpoint
156 --containerd-namespace="k8s.io"
159 containerd namespace
160 --context=""
163 The name of the kubeconfig context to use
164 --default-not-ready-toleration-seconds=300
167 Indicates the tolerationSeconds of the toleration for
168 notReady:NoExecute that is added by default to every pod that does not
169 already have such a toleration.
170 --default-unreachable-toleration-seconds=300
173 Indicates the tolerationSeconds of the toleration for unreach‐
174 able:NoExecute that is added by default to every pod that does not
175 already have such a toleration.
176 --docker="unix:///var/run/docker.sock"
179 docker endpoint
180 --docker-env-metadata-whitelist=""
183 a comma-separated list of environment variable keys that needs to
184 be collected for docker containers
185 --docker-only=false
188 Only report docker containers in addition to root stats
189 --docker-root="/var/lib/docker"
192 DEPRECATED: docker root is read from docker info (this is a fall‐
193 back, default: /var/lib/docker)
194 --docker-tls=false
197 use TLS to connect to docker
198 --docker-tls-ca="ca.pem"
201 path to trusted CA
202 --docker-tls-cert="cert.pem"
205 path to client certificate
206 --docker-tls-key="key.pem"
209 path to private key
210 --enable-load-reader=false
213 Whether to enable cpu load reader
214 --event-storage-age-limit="default=0"
217 Max length of time for which to store events (per type). Value is a
218 comma separated list of key values, where the keys are event types
219 (e.g.: creation, oom) or "default" and the value is a duration. Default
220 is applied to all non-specified event types
221 --event-storage-event-limit="default=0"
224 Max number of events to store (per type). Value is a comma sepa‐
225 rated list of key values, where the keys are event types (e.g.: cre‐
226 ation, oom) or "default" and the value is an integer. Default is
227 applied to all non-specified event types
228 --global-housekeeping-interval=1m0s
231 Interval between global housekeepings
232 --housekeeping-interval=10s
235 Interval between container housekeepings
236 --insecure-skip-tls-verify=false
239 If true, the server's certificate will not be checked for validity.
240 This will make your HTTPS connections insecure
241 --kubeconfig=""
244 Path to the kubeconfig file to use for CLI requests.
245 --log-backtrace-at=:0
248 when logging hits line file:N, emit a stack trace
249 --log-cadvisor-usage=false
252 Whether to log the usage of the cAdvisor container
253 --log-dir=""
256 If non-empty, write log files in this directory
257 --log-file=""
260 If non-empty, use this log file
261 --log-file-max-size=1800
264 Defines the maximum size a log file can grow to. Unit is megabytes.
265 If the value is 0, the maximum file size is unlimited.
266 --log-flush-frequency=5s
269 Maximum number of seconds between log flushes
270 --logtostderr=true
273 log to standard error instead of files
274 --machine-id-file="/etc/machine-id,/var/lib/dbus/machine-id"
277 Comma-separated list of files to check for machine-id. Use the
278 first one that exists.
279 --match-server-version=false
282 Require server version to match client version
283 -n, --namespace=""
286 If present, the namespace scope for this CLI request
287 --password=""
290 Password for basic authentication to the API server
291 --profile="none"
294 Name of profile to capture. One of (none|cpu|heap|goroutine|thread‐
295 create|block|mutex)
296 --profile-output="profile.pprof"
299 Name of the file to write the profile to
300 --request-timeout="0"
303 The length of time to wait before giving up on a single server
304 request. Non-zero values should contain a corresponding time unit (e.g.
305 1s, 2m, 3h). A value of zero means don't timeout requests.
306 -s, --server=""
309 The address and port of the Kubernetes API server
310 --skip-headers=false
313 If true, avoid header prefixes in the log messages
314 --skip-log-headers=false
317 If true, avoid headers when opening log files
318 --stderrthreshold=2
321 logs at or above this threshold go to stderr
322 --storage-driver-buffer-duration=1m0s
325 Writes in the storage driver will be buffered for this duration,
326 and committed to the non memory backends as a single transaction
327 --storage-driver-db="cadvisor"
330 database name
331 --storage-driver-host="localhost:8086"
334 database host:port
335 --storage-driver-password="root"
338 database password
339 --storage-driver-secure=false
342 use secure connection with database
343 --storage-driver-table="stats"
346 table name
347 --storage-driver-user="root"
350 database username
351 --token=""
354 Bearer token for authentication to the API server
355 --update-machine-info-interval=5m0s
358 Interval between machine info updates.
359 --user=""
362 The name of the kubeconfig user to use
363 --username=""
366 Username for basic authentication to the API server
367 -v, --v=0
370 number for the log level verbosity
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 # Edit the last-applied-configuration annotations by type/name in YAML.
385 kubectl apply edit-last-applied deployment/nginx
386 # Edit the last-applied-configuration annotations by file in JSON.
388 kubectl apply edit-last-applied -f deploy.yaml -o json
389
394 kubectl-apply(1),
395
399 January 2015, Originally compiled by Eric Paris (eparis at redhat dot
400 com) based on the kubernetes source material, but hopefully they have
401 been automatically generated since!
402Eric Paris kubernetes User Manuals KUBERNETES(1)