64

As stated in the title, is it possible to find out a K8s cluster name from the API? I looked around the API and could not find it.

tback
  • 9,418
  • 5
  • 38
  • 67
Alex
  • 4,514
  • 3
  • 22
  • 32

11 Answers11

54

kubectl config current-context does the trick (it outputs little bit more, like project name, region, etc., but it should give you the answer you need).

usamec
  • 1,860
  • 2
  • 16
  • 22
  • 9
    The context name can be renamed manually and therefore unreliable. – Akihiro HARAI Jun 12 '19 at 02:00
  • 1
    @AkihiroHARAI yes you can rename it manually. But: a) why would you do that? b) running `gcloud container clusters get-credentials` sets the context back. – usamec Jun 16 '19 at 20:32
  • 5
    I wonder why this answer has so many upvotes. `config current-context` doesn't do any k8s API calls, it just reads locally stored `kubectl` config (which is not even, strictly speaking, a part of kubernetes, just a client for its apis). – edio Oct 12 '19 at 14:31
  • @edio because question has tag "google-kubernetes-engine" and this solves problem of finding which cluster you are connected to on GKE – usamec Oct 17 '19 at 12:12
  • 2
    @usamec, the question was about kubernetes **API**. Executing kubectl, which will likely won't be even installed in a POD with a running application is very far from kubernetes API. By this logic I could also suggest to the topic starter to open a browser, navigate to google console and check cluster name in GKE UI. – edio Oct 18 '19 at 13:13
19

I dont believe there is a k8s cluster name. This command could provide some nice informations

kubectl cluster-info

Bhaal22
  • 569
  • 2
  • 10
  • I'm sorry I downvoted for `kubectl cluster-info` not returning a name. Here, take the bounty instead. See http://stackoverflow.com/a/43667827/246241 for the kubernetes ticket. – tback May 03 '17 at 07:20
19

Unfortunately a cluster doesn't know its own name, or anything else that would uniquely identify it (K8s issue #44954). I wanted to know for helm issue #2055.

John Topley
  • 107,187
  • 45
  • 188
  • 235
tback
  • 9,418
  • 5
  • 38
  • 67
12

The question is not really well described. However, if this question is related to Google Container Engine then as coreypobrien mentioned the name of cluster is stored in custom metadata of nodes. From inside a node, run the following command and the output will be name of cluster:

curl http://metadata/computeMetadata/v1/instance/attributes/cluster-name -H "Metadata-Flavor: Google"

If you specify your use case, I might be able to extend my answer to cover it.

Kamran
  • 3,047
  • 23
  • 40
10

The kubernetes API doesn't know much about the GKE cluster name, but you can easily get the cluster name from the Google metatdata server like this

kubectl run curl --rm --restart=Never -it --image=appropriate/curl -- -H "Metadata-Flavor: Google" http://metadata.google.internal/computeMetadata/v1/instance/attributes/cluster-name
coreypobrien
  • 1,561
  • 14
  • 16
  • This is the answer I have been looking for all day; I needed to see the full list of instance attributes available. `kubectl run curl --rm --restart=Never -it --image=appropriate/curl -- -H "Metadata-Flavor: Google" http://metadata.google.internal/computeMetadata/v1/instance/attributes/` – durp Oct 01 '18 at 21:29
  • how can I avoid having kubectl print "pod curl deleted" at the end? – Alex Flint Dec 18 '18 at 20:26
  • 1
    Add `--quiet` after `run`. The entire command would be `kubectl run --quiet curl --rm --restart=Never -it --image=appropriate/curl -- -H "Metadata-Flavor: Google" http://metadata.google.internal/computeMetadata/v1/instance/attributes/cluster-name > cluster_name`. @AlexFlint – Akihiro HARAI Jun 12 '19 at 02:04
8

In case the name you have in your .kube/config file is enough for you, this one-liner does the trick:

kubectl config view --minify -o jsonpath='{.clusters[].name}'

Note 1: The --minify is key here so it will output the name of your current context only. There are other similar answers posted here but without the "minify" you will be listing other contexts in your config that might confuse you.

Note 2: The name in your .kube/config might not reflect the name in your cloud provider, if the file was autogenerated by the cloud provider the name should match, if you configured it manually you could have typed any name just for local config.

Note 3: Do not rely on kubectl config current-context this returns just the name of the context, not the name of the cluster.

sapeish
  • 491
  • 6
  • 14
6

It is the same as getting the current config, but the below command gives clear output:

kubectl config view

jkdev
  • 9,037
  • 14
  • 52
  • 75
Binoy Thomas
  • 121
  • 1
  • 5
  • 1
    This was useful for me! I ran `kubectl config view -o json`. I was then able to determine my "current-cluster" by using the current context and mapping that to the contexts to get the current cluster name. Thanks! – Rob McCabe Jul 21 '19 at 01:13
4

This command will Check all possible clusters, as you know .KUBECONFIG may have multiple contexts

kubectl config view -o jsonpath='{"Cluster name\tServer\n"}{range .clusters[*]}{.name}{"\t"}{.cluster.server}{"\n"}{end}'

And you will get output like

Cluster name    Server
kubernetes      https://localhost:6443
UDIT JOSHI
  • 740
  • 5
  • 16
2

Well this returns precisely one thing, a cluster name

K8s: kubectl config view -o jsonpath='{.clusters[].name}{"\n"}'

Openshift: oc config view -o jsonpath='{.clusters[].name}{"\n"}'

dejdej
  • 2,590
  • 4
  • 16
  • 28
bortek
  • 93
  • 7
  • This is incorrect! it just return the FIRST cluster name. This may be diffrent than the cluster of the curent context. – Polymerase Apr 02 '21 at 15:56
1

For clusters that were installed using kubeadm, the configuration stored in the kubeadm-config configmap has the cluster name used when installing the cluster.

$ kubectl -n kube-system get configmap kubeadm-config -o yaml

apiVersion: v1
kind: ConfigMap
metadata:
  name: kubeadm-config
  namespace: kube-system
data:
  ClusterConfiguration: |
    clusterName: NAME_OF_CLUSTER

For clusters that are using CoreDNS for their DNS, the "cluster name" from kubeadm is also used as the domain suffix.

$ kubectl -n kube-system get configmap coredns -o yaml

apiVersion: v1
kind: ConfigMap
metadata:
  name: coredns
  namespace: kube-system
data:
  Corefile: |
    .:53 {
        kubernetes NAME_OF_CLUSTER.local in-addr.arpa ip6.arpa {
Evgeny
  • 5,247
  • 3
  • 49
  • 58
0

$ kubectl config get-clusters --> get you the list of existing clusters