OC(1)

📦
version 4.22.0 · 2 versions
, in nixpkgs unstable

💅 OC(1) — the oc scale glow-up, bestie ✨

okay so real talk, this is the OpenShift CLI User Manuals page for oc scale, and it's genuinely one of the most useful little commands in the whole oc universe. Sit down, grab a strawberry drink 🍓, we're learning how to resize stuff.

🌸 NAME 🌸

oc scale — the way you set a brand-new size for a deployment, replica set, or replication controller. literally that's the whole assignment 💅

✨ SYNOPSIS ✨

oc scale [OPTIONS]

🦋 DESCRIPTION 🦋

So what this does is: set a new size for a deployment, replica set, replication controller, or stateful set. one number in, vibes out. no cap.

And here's the cute part — scale also lets you specify one or more preconditions for the scale action 🎀 like, "only do this if the current situation is exactly what I think it is."

If you pass --current-replicas or --resource-version, that gets validated before the scale is attempted, and it is guaranteed that the precondition holds true when the scale is sent to the server. so it's not just vibes, it's verified vibes. 🔥

👑 OPTIONS 👑

  • --all=false — select all resources in the namespace of the specified resource types. everything. the whole group chat 😭
  • --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 forgiving, we love her 🫶
  • --current-replicas=-1 — precondition for current size. requires that the current size of the resource match this value in order to scale. -1 (the default) means no condition at all. default = unbothered, moisturized, in her lane ✨
  • --dry-run="none" — must be "none", "server", or "client". if it's the client strategy, only print the object that would be sent, without sending it. if it's the server strategy, submit the server-side request without persisting the resource. it's giving "let me rehearse the text before I send it" 💀
  • -f, --filename=[] — filename, directory, or URL to files identifying the resource to set a new size. yes bestie, a URL counts, we're flexible 🦋
  • -k, --kustomize="" — process the kustomization directory. this flag can't be used together with -f or -R. it's an exclusive little icon, pick one 🎀
  • -o, --output="" — output format. one of: json, yaml, kyaml, name, go-template, go-template-file, template, templatefile, jsonpath, jsonpath-as-json, jsonpath-file. so many flavors, pick your favorite 🍓
  • -R, --recursive=false — process the directory used in -f, --filename recursively. useful when you want to manage related manifests organized within the same directory. she goes deep 💅
  • --replicas=0 — the new desired number of replicas. required. like, this is the whole point, don't forget her 😭
  • --resource-version="" — precondition for resource version. requires that the current resource version match this value in order to scale. another safety rail, we stan a cautious queen 🫶
  • -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 skipping 🔥
  • --show-managed-fields=false — if true, keep the managedFields when printing objects in JSON or YAML format. for the girlies who need every detail 📋
  • --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⟩ ]. fancy ✨
  • --timeout=0 — the length of time to wait before giving up on a scale operation. zero means don't wait. any other values should contain a corresponding time unit (e.g. 1s, 2m, 3h). patience is a unit, and honestly 0 has none 💀

🧚 OPTIONS INHERITED FROM PARENT COMMANDS 🧚

these aren't oc scale's own flags — they're handed down from the parent command like a family heirloom 💜

  • --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. stack 'em 🌈
  • --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. repeat icon 🎀
  • --cache-dir="/homeless-shelter/.kube/cache" — default cache directory. yes, that path is exactly as written, don't @ me 😭
  • --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. uncompressed and unbothered ✨
  • --insecure-skip-tls-verify=false — if true, the server's certificate will not be checked for validity. this will make your HTTPS connections insecure. ⚠️ redirecting your attention to this one, bestie, it's literally in the name.
  • --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. iykyk 🦋
  • --match-server-version=false — require server version to match client version. matching outfits, but for software 👑
  • -n, --namespace="" — if present, the namespace scope for this CLI request.
  • --profile="none" — name of profile to capture. one of (none|cpu|heap|goroutine|threadcreate|block|mutex).
  • --profile-output="profile.pprof" — name of the file to write the profile to.
  • --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.
  • --warnings-as-errors=false — treat warnings received from the server as errors and exit with a non-zero exit code. strict queen behavior 💅

🌈 EXAMPLE 🌈

okay here's where it gets good, these are literally copy-paste ready:

# Scale a replica set named 'foo' to 3
oc scale --replicas=3 rs/foo

# Scale a resource identified by type and name specified in "foo.yaml" to 3
oc scale --replicas=3 -f foo.yaml

# If the deployment named mysql's current size is 2, scale mysql to 3
oc scale --current-replicas=2 --replicas=3 deployment/mysql

# Scale multiple replication controllers
oc scale --replicas=5 rc/example1 rc/example2 rc/example3

# Scale stateful set named 'web' to 3
oc scale --replicas=3 statefulset/web

the third one is my personal main character — it only scales mysql if she's currently at 2. conditional slay 🔥

🎀 SEE ALSO 🎀

  • oc(1) — the mothership. go say hi 💖

📜 HISTORY 📜

June 2016, ported from the Kubernetes man-doc generator. vintage. a classic. she's been iconic since 2016 👑

ngl bestie, the only thing you really have to remember is --replicas is required. everything else is seasoning 🧂✨

and that's the page!! brought to you by Openshift — Openshift CLI User Manuals — dated June 2016 🫶 go scale something, you got this 💜

📦 where this page comes from