KUBERNETES(1)(kubernetes)

💖 KUBERNETES(1)(kubernetes) 💖

okay bestie, sit down, grab your boba, because we're doing kubectl rollout restart and it's literally the "turn it off and on again" of Kubernetes but make it ✨official✨. This page is from the kubernetes manual, originally scribbled into existence by Eric Paris back in Jan 2015, and it has been carrying the whole rollout game ever since. 🫶

---

✨ NAME ✨

kubectl rollout restart — Restart a resource 🔄

---

🌸 SYNOPSIS 🌸

kubectl rollout restart [OPTIONS]

---

🦋 DESCRIPTION 🦋

Restart a resource.

Like, that's it. That's the whole vibe.

Resource rollout will be restarted.

fr fr that's the entire description, no cap. It does the thing it says it does. 💅

---

🎀 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. (So if your template is missing a lil key, it just shrugs instead of crying. 🙈)
• --field-manager="kubectl-rollout" — Name of the manager used to track field ownership. That's literally the name it signs on the field-ownership guestbook, bestie.
• -f, --filename=[] — Filename, directory, or URL to files identifying the resource to get from a server.
• -k, --kustomize="" — Process the kustomization directory. This flag can't be used together with -f or -R. (pick a lane, babes 🚫)
• -o, --output="" — Output format. One of: (json, yaml, kyaml, name, go-template, go-template-file, template, templatefile, jsonpath, jsonpath-as-json, jsonpath-file). Choose your aesthetic ✨
• -R, --recursive=false — Process the directory used in -f, --filename recursively. Useful when you want to manage related manifests organized within the same directory. (going down the whole folder tree like a detective 🔍)
• -l, --selector="" — Selector (label query) to filter on, supports '=', '==', '!=', 'in', 'notin'. (e.g. -l key1=value1,key2=value2,key3 in (value3)). Matching objects must satisfy all of the specified label constraints. Every single one. No partial credit. 👑
• --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 are the family heirlooms, passed down from the parent command, and they're iconic:

• --as="" — Username to impersonate for the operation. User could be a regular user or a service account in a namespace. (cosplay, but make it auth 🔥)
• --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. 🚨

bestie, this one is literally called "insecure". The name is the warning. Do not. I'm begging. 😭

• --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

---

🌈 EXAMPLE 🌈

the moment you've all been waiting for, the main character examples 💫

# Restart all deployments in the test-namespace namespace
kubectl rollout restart deployment -n test-namespace

# Restart a deployment
kubectl rollout restart deployment/nginx

# Restart a daemon set
kubectl rollout restart daemonset/abc

# Restart deployments with the app=nginx label
kubectl rollout restart deployment --selector=app=nginx

see how clean that is?? ate and left no crumbs 🍓

---

⭐ SEE ALSO ⭐

kubectl-rollout(1),

(yes, go read that one next, it's the whole rollout family reunion 🧚)

---

👑 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 tea, bestie 💅 this whole thing lives in the kubernetes manual (section 1), and this version of the page is dated Jan 2015 — shoutout to Eric Paris for the original compile, and to the auto-generators who (hopefully, per the manpage's own words) took over the job since. 💖✨🦋

slay, go restart something responsibly 🫶