kubectl rollout error: unknown command restart deployment

Written by Claudio Kuenzler - 0 comments

Published on January 25th 2024 - Listed in Kubernetes Cloud Rancher Containers

---

When I wanted to use kubectl to restart a deployment (rancher) in the cattle-system namespace, I had to raise an eyebrow when I got the following error:

ck@mint ~ $ kubectl rollout restart deployment rancher -n cattle-system
error: unknown command "restart deployment rancher"

In case you wonder what this command is supposed to do inside a Kubernetes cluster:

In Kubernetes, kubectl rollout restart is a command used to start a new rollout process for three specific Kubernetes objects: Deployment, DaemonSet, and StatefulSet. A rollout process essentially means a gradual, step-by-step recreation of Pods — The old Pods are not removed entirely until the new Pods are running successfully. This process ensures that your application remains available throughout the restart process. - kodekloud.com/blog/kubectl-rollout-restart/

There is no rollout restart sub-command!

Turns out this sub-command "rollout restart" does indeed not exist:

ck@mint ~ $ kubectl rollout --help
Manage the rollout of a resource.

 Valid resource types include:

  *  deployments
  *  daemonsets
  *  statefulsets

Examples:
  # Rollback to the previous deployment
  kubectl rollout undo deployment/abc

  # Check the rollout status of a daemonset
  kubectl rollout status daemonset/foo

Available Commands:
  history     View rollout history
  pause       Mark the provided resource as paused
  resume      Resume a paused resource
  status      Show the status of the rollout
  undo        Undo a previous rollout

Usage:
  kubectl rollout SUBCOMMAND [options]

Use "kubectl <command> --help" for more information about a given command.
Use "kubectl options" for a list of global command-line options (applies to all commands).

But it also turned out that this way a very old version of kubectl:

ck@mint ~ $ kubectl version
Client Version: version.Info{Major:"1", Minor:"14", GitVersion:"v1.14.6", GitCommit:"96fac5cd13a5dc064f7d9f4f23030a6aeface6cc", GitTreeState:"clean", BuildDate:"2019-08-19T11:13:49Z", GoVersion:"go1.12.9", Compiler:"gc", Platform:"linux/amd64"}

On this machine, kubectl 1.14.6 is installed - that's old (certainly when looking at the Kubernetes release schedules)!

kubectl rollout restart using newer cli version

The rollout restart sub-command was added in Kubernetes 1.15 and mentions the following in the Kubernetes v1.15 release notes:

• Created a new kubectl rollout restart command that does a rolling restart of a deployment. (#76062, @apelisse)
• kubectl rollout restart now works for DaemonSets and StatefulSets. (#77423, @apelisse)

Success!

Add a comment

Show form to leave a comment

Comments (newest first)

No comments yet.