kubectl-scale

Scale deployment replicas

$ kubectl scale deployment [name] --replicas=[3]

$ kubectl scale deployment [name1] [name2] --replicas=[3]

$ kubectl scale deployment [name] --current-replicas=[2] --replicas=[3]

$ kubectl scale -f [manifest.yaml] --replicas=[5]

kubectl scale type name --replicas=count [options]

kubectl scale adjusts the replica count for deployments, replica sets, replication controllers, and stateful sets, allowing you to increase or decrease the number of running pod instances on demand. Changes take effect immediately, with the Kubernetes controller manager working to reconcile the actual state to the desired replica count.
The command supports a precondition flag (--current-replicas) that causes the scaling operation to fail if the current number of replicas does not match the expected value, which is useful for preventing race conditions in automated workflows. You can also scale resources defined in manifest files and apply the operation to multiple resources in a single invocation.

--replicas count

Target number of replicas.

Precondition for current replicas.

Resource file to scale.

Timeout for scaling operation.

kubectl(1), kubectl-autoscale(1)