KUBERNETES(1)(kubernetes)

πŸ’– KUBERNETES(1) β€” the kubectl girlies' manual πŸ’–

kubectl apply set-last-applied β€” okay bestie, this is a kubernetes manual page, section 1, from the User manuals, and it was originally written by Eric Paris back in January 2015 (yes, ancient, but she still serves πŸ’…). Pull up a chair, grab a boba, and let's get into it.


✨ NAME ✨

kubectl apply set-last-applied β€” Set the last-applied-configuration annotation on a live object to match the contents of a file πŸŽ€


🌸 SYNOPSIS 🌸

kubectl apply set-last-applied [OPTIONS]

πŸ¦‹ DESCRIPTION πŸ¦‹

So the vibe here is: you're setting the latest last-applied-configuration annotations by pointing them at the contents of a file. Literally just matching them up. ✨

The result? The last-applied-configuration gets updated as though kubectl apply -f was run, but β€” and this is the important part, no cap β€” without updating any other parts of the object. She only touches the annotation. Nothing else. Iconic behavior honestly.


πŸ’… OPTIONS πŸ’…

  • --allow-missing-template-keys=true β€” If true, ignore any errors in templates when a field or map key is missing in the template. Only applies to golang and jsonpath output formats.
  • --create-annotation=false β€” Will create last-applied-configuration annotations if current objects doesn't have one.
  • --dry-run="none" β€” Must be "none", "server", or "client". If client strategy, only print the object that would be sent, without sending it. If server strategy, submit server-side request without persisting the resource.
  • -f, --filename=[] β€” Filename, directory, or URL to files that contains the last-applied-configuration annotations.
  • -o, --output="" β€” Output format. One of: (json, yaml, kyaml, name, go-template, go-template-file, template, templatefile, jsonpath, jsonpath-as-json, jsonpath-file).
  • --show-managed-fields=false β€” If true, keep the managedFields when printing objects in JSON or YAML format.
  • --template="" β€” Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview].

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

These ones you get for free from the parent command, like hand-me-downs but make it auth.

  • --as="" β€” Username to impersonate for the operation. User could be a regular user or a service account in a namespace.
  • --as-group=[] β€” Group to impersonate for the operation, this flag can be repeated to specify multiple groups.
  • --as-uid="" β€” UID to impersonate for the operation.
  • --as-user-extra=[] β€” User extras to impersonate for the operation, this flag can be repeated to specify multiple values for the same key.
  • --cache-dir="/home/username/.kube/cache" β€” Default cache directory.
  • --certificate-authority="" β€” Path to a cert file for the certificate authority.
  • --client-certificate="" β€” Path to a client certificate file for TLS.
  • --client-key="" β€” Path to a client key file for TLS.
  • --cluster="" β€” The name of the kubeconfig cluster to use.
  • --context="" β€” The name of the kubeconfig context to use.
  • --disable-compression=false β€” If true, opt-out of response compression for all requests to the server.
  • --insecure-skip-tls-verify=false β€” If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure.
  • --kubeconfig="" β€” Path to the kubeconfig file to use for CLI requests.
  • --kuberc="" β€” Path to the kuberc file to use for preferences. This can be disabled by exporting KUBECTL_KUBERC=false feature gate or turning off the feature KUBERC=off.
  • --match-server-version=false β€” Require server version to match client version.
  • -n, --namespace="" β€” If present, the namespace scope for this CLI request.
  • --password="" β€” Password for basic authentication to the API server.
  • --profile="none" β€” Name of profile to capture. One of (none|cpu|heap|goroutine|threadcreate|block|mutex|trace).
  • --profile-output="profile.pprof" β€” Name of the file to write the profile to.
  • --proxy-url="" β€” Proxy URL to use for requests to the API server.
  • --request-timeout="0" β€” The length of time to wait before giving up on a single server request. Non-zero values should contain a corresponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't timeout requests.
  • -s, --server="" β€” The address and port of the Kubernetes API server.
  • --tls-server-name="" β€” Server name to use for server certificate validation. If it is not provided, the hostname used to contact the server is used.
  • --token="" β€” Bearer token for authentication to the API server.
  • --user="" β€” The name of the kubeconfig user to use.
  • --username="" β€” Username for basic authentication to the API server.
  • --version=false β€” --version, --version=raw prints version information and quits; --version=vX.Y.Z... sets the reported version.
  • --warnings-as-errors=false β€” Treat warnings received from the server as errors and exit with a non-zero exit code.
⚠️ okay real talk bestie: that --insecure-skip-tls-verify one says the quiet part out loud β€” skipping validity checks makes your HTTPS connections insecure. She's not being dramatic, that's just what it says. πŸ™ˆ

πŸ“ EXAMPLE πŸ“

# Set the last-applied-configuration of a resource to match the contents of a file
kubectl apply set-last-applied -f deploy.yaml

# Execute set-last-applied against each configuration file in a directory
kubectl apply set-last-applied -f path/

# 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
kubectl apply set-last-applied -f deploy.yaml --create-annotation=true

🧚 SEE ALSO 🧚


πŸ‘‘ HISTORY πŸ‘‘

January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! 😭


And that's the whole page, bestie. Go set those annotations. πŸ’–

Sign-off corner πŸŽ€: this is the User manual, section 1, for KUBERNETES, dated January 2015 β€” generated from the kubernetes source material, and you know what? It ate. Periodt. πŸ’…βœ¨

πŸ“¦ where this page comes from