OC-ADM-WAIT-FOR-STABLE-CLUSTER(1)

πŸ“¦
version 4.22.0 Β· 2 versions
, in nixpkgs unstable

πŸ’… oc adm wait-for-stable-cluster β€” like, the manual page, bestie

okay so this is oc adm from the OC ADM(1) manual, dated June 2016, and the star of the show today is wait-for-stable-cluster. she's a patient queen. let's get into it 🫢


✨ NAME ✨

oc adm wait-for-stable-cluster β€” literally just sits there and waits for your platform operators to stop being chaotic and become stable. main character patience energy πŸ’…


🌸 SYNOPSIS 🌸

oc adm wait-for-stable-cluster [OPTIONS]

πŸ¦‹ DESCRIPTION πŸ¦‹

okay so picture this: you're waiting for every single one of your OCP v4 clusteroperators to report Available=true, Progressing=false, and Degraded=false. that's the whole vibe check. that's it. that's the command. she waits until all of them are slaying at the same time ✨


πŸŽ€ OPTIONS πŸŽ€

  • --minimum-stable-period=0 β€” the minimum duration you need before the cluster counts as stable. ngl the default value says 0 but the default behaviour is 5 minutes. iconic of her to keep us guessing 😭
  • --timeout=0 β€” how long before the command gives up and times out. the default here is 1 hour, bestie. she's not gonna wait forever πŸ•

πŸ‘‘ OPTIONS INHERITED FROM PARENT COMMANDS πŸ‘‘

these are the hand-me-downs from the parent command and they are, honestly, a lot. but they're all yours πŸ’œ

  • --as="" β€” username to impersonate for the operation. 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.
  • --cache-dir="/homeless-shelter/.kube/cache" β€” default cache directory. yes that is genuinely the path. no we don't know why either πŸ’€
  • --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, you're opting 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. like actually. be careful with this one πŸ™ˆ
  • --kubeconfig="" β€” path to the kubeconfig file to use for CLI requests.
  • --kuberc="" β€” path to the kuberc file to use for preferences. you can turn this off by exporting the KUBECTL_KUBERC=false feature gate, or by turning off the feature with KUBERC=off.
  • --match-server-version=false β€” require server version to match client version.
  • -n, --namespace="" β€” if present, the namespace scope for this CLI request.
  • --profile="none" β€” name of the 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. she'll wait forever, lowkey πŸ•°οΈ
  • -s, --server="" β€” the address and port of the Kubernetes API server.
  • --tls-server-name="" β€” server name to use for server certificate validation. if it's 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 behaviour πŸ‘‘

🌈 EXAMPLE 🌈

fr fr here's how you actually use her:

# Wait for all cluster operators to become stable
oc adm wait-for-stable-cluster

# Consider operators to be stable if they report as such for 5 minutes straight
oc adm wait-for-stable-cluster --minimum-stable-period 5m

⭐ SEE ALSO ⭐


🧚 HISTORY 🧚

June 2016 β€” ported from the Kubernetes man-doc generator. vintage. retro. a little bit legendary, honestly πŸŽ€


and that's the whole thing, bestie! this page comes to you from Openshift CLI User Manuals, version Openshift, dated June 2016 β€” go forth and wait for stability, you've got this πŸ’–βœ¨

πŸ“¦ where this page comes from