KUBERNETES(1)(kubernetes)

📦
version 1.37.2 · 6 versions
, in arch rolling, fedora 43, fedora 44, nixpkgs unstable

✨ KUBERNETES ✨

okay bestie, welcome to the kubectl cinematic universe 💖 this one's from the kubernetes manual, section 1, and it was originally written up by Eric Paris back in Jan 2015. pull up a chair, we're gonna get you fluent in cluster gossip 🫶

💅 NAME

kubectl config get-clusters — shows you all the clusters defined in your kubeconfig 👑

🌸 SYNOPSIS

kubectl config get-clusters [OPTIONS]

🦋 DESCRIPTION

Displays the clusters defined in the kubeconfig. that's it, that's the whole vibe. it's giving "let me see who's in the group chat" 💖

🎀 OPTIONS INHERITED FROM PARENT COMMANDS

these don't belong to get-clusters itself, they're inherited from the parent command, so they're just always chillin' in the background, ready to be useful ✨

  • --as="" — the username you wanna impersonate for the operation. could be a regular user, could be a service account hanging out in a namespace 👀
  • --as-group=[] — the group you wanna impersonate for the operation. repeat this flag as many times as you want to stack up multiple groups 🫶
  • --as-uid="" — the UID you wanna impersonate for the operation 💫
  • --as-user-extra=[] — user extras to impersonate for the operation. repeat this flag to set multiple values for the same key 🔁
  • --cache-dir="/home/username/.kube/cache" — the default cache directory, exactly where it says on the tin 🗂️
  • --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 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. heads up: this makes your HTTPS connections insecure 😭 please be careful, bestie
  • --kubeconfig="" — use a particular kubeconfig file 📁
  • --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 the server version to match the client version 🤝
  • -n, --namespace="" — if present, the namespace scope for this CLI request 📍
  • --password="" — password for basic authentication to the API server 🔑
  • --profile="none" — name of the profile to capture. one of (none|cpu|heap|goroutine|threadcreate|block|mutex|trace) 📊
  • --profile-output="profile.pprof" — name of the file to write the profile to 📝
  • --proxy-url="" — proxy URL to use for requests to the API server 🌉
  • --request-timeout="0" — how long to wait before giving up on a single server request. non-zero values should contain a matching time unit (like 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'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 🙋
  • --username="" — username for basic authentication to the API server 👤
  • --version=false — --version, --version=raw prints version information and quits; --version=vX.Y.Z... sets the reported version 🔢
  • --warnings-as-errors=false — treat warnings received from the server as errors and exit with a non-zero exit code ⚠️

🌈 EXAMPLE

# List the clusters that kubectl knows about
kubectl config get-clusters

👑 SEE ALSO

kubectl-config(1),

💜 HISTORY

January 2015, originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material — but hopefully they have been automatically generated since! 😌

and that's the whole page, bestie 💖 no cap. this gem comes from the kubernetes manual, user section, dated Jan 2015, and it's version KUBERNETES(1)(kubernetes) — go forth and list those clusters, you absolute icon 🎀✨

📦 where this page comes from