OC(1)

✨ OC(1) — the oc plugin page, but make it a group chat ✨

okay so bestie, you found the OC(1) manual page for oc plugin. It’s giving “utilities for interacting with plugins,” and we’re about to go through every single inherited flag together. 💅

🌸 NAME 🌸

oc plugin — provides utilities for interacting with plugins. That’s the whole name, and honestly it ate. ✨

🦋 SYNOPSIS 🦋

oc plugin [OPTIONS]

🎀 DESCRIPTION 🎀

Plugins are the moment when you want extended functionality that is not part of the major command-line distribution. It’s giving extra, on purpose. 💖

Wanna write your own plugins? The documentation and examples have more information about how to write your own plugins. Go read them, iykyk. 🫶

The easiest way to discover and install plugins is via the kubernetes sub-project krew: [krew.sigs.k8s.io]. To install krew, visit ⟨https://krew.sigs.k8s.io/docs/user-guide/setup/install⟩. 🌈

💅 OPTIONS INHERITED FROM PARENT COMMANDS 💅

These are inherited from the parent commands, but they still matter for this page. Every default is right here, no cap. 👑

• --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. 🚨 no cap, that’s the warning 🚨
• --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 🌟

Try these on for size, bestie:

# List all available plugins
oc plugin list

# List only binary names of available plugins without paths
oc plugin list --name-only

👀 SEE ALSO 👀

Go say hi to oc(1) and oc-plugin-list(1). 💖

🕰️ HISTORY 🕰️

June 2016, Ported from the Kubernetes man-doc generator. That’s the lore. 🫶

mwah 💋 — from Openshift, the Openshift CLI User Manuals, and your fave OC(1) page, dated June 2016. 🎀