OC-ADM-PRUNE-BUILDS(1)

📦
version 4.22.0 · 2 versions
, in nixpkgs unstable

🌸 OC ADM PRUNE BUILDS(1) 🌸

okay bestie, welcome to the OpenShift CLI User Manuals section of your life 💅 this one lives in oc adm prune and it's literally all about clearing out your old builds. buckle up 🎀

✨ NAME ✨

oc adm prune builds — remove old completed and failed builds 🗑️✨

🦋 SYNOPSIS 🦋

oc adm prune builds [OPTIONS]

💖 DESCRIPTION 💖

Prune old completed and failed builds. that's it, that's the whole vibe 🧹

By default, the prune operation performs a dry run making no changes to internal registry — so like, it's window shopping only 👀 you need a --confirm flag for changes to actually be effective. no confirm, no deleting. periodt.

⚠️ ngl, this is the part everyone skips: without --confirm nothing gets deleted, fr fr. it just tells you what would go.

⭐ OPTIONS ⭐

  • --confirm=false — if true, specify that build pruning should proceed. defaults to false, which means it displays what would be deleted but does not actually delete anything 🙈
  • --keep-complete=5 — per BuildConfig, specify the number of builds whose status is complete that will be preserved 💖
  • --keep-failed=1 — per BuildConfig, specify the number of builds whose status is failed, error, or cancelled that will be preserved 🫶
  • --keep-younger-than=0 — specify the minimum age of a Build for it to be considered a candidate for pruning ⏳
  • --orphans=false — if true, prune all builds whose associated BuildConfig no longer exists and whose status is complete, failed, error, or cancelled 👻

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

these are the hand-me-downs from the parent command, and yes there are a lot of them, but we're listing every single one because we don't do half measures here 💅

  • --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 🎀
  • --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 📁
  • --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 💀 (like, actually insecure, be careful)
  • --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
  • --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 😭

🔥 EXAMPLE 🔥

here's the iconic demo, bestie — dry run first, then confirm 👑

# Dry run deleting older completed and failed builds and also including
# all builds whose associated build config no longer exists
oc adm prune builds --orphans

# To actually perform the prune operation, the confirm flag must be appended
oc adm prune builds --orphans --confirm

see how the second one has --confirm? that's the difference between "hmm interesting" and "it's gone" 💀✨

👑 SEE ALSO 👑

🍓 HISTORY 🍓

June 2016, Ported from the Kubernetes man-doc generator 📜

and that's the whole page, bestie 🫶 you ate that 💜

Openshift — Openshift CLI User Manuals — June 2016 🌸 (yes the source/version and date go here, cute sign-off style, mwah 💋)

📦 where this page comes from