Get a kubeconfig#
Note
The following documentation assumes you have installed kubectl for your OS. Follow the steps here if you have not.
What is a kubeconfig?#
In kubernetes (k8s) you access and interact with the k8s cluster by using a kubeconfig. The link provides much more in depth information but in summary the kubeconfig is a yaml file that contains the server address, certificates, and secret information to securely authenticate to the cluster. In order to interact with a k8s cluster we need to obtain the kubeconfig for that cluster and either store it in a known location or specify the location of the file.
Login to Rancher#
The link to NCARs Rancher instance is always at the top of this documentation under the Resources tab. Navigate to rancher, provide your CIT credentials, and select Log in with ActiveDirectory.
Note
In the username field please specify the domain before your username : ie. CIT\username
Navigate to Cluster#
Note
As of the writing of this document there is only one cluster in Rancher. It will be used for this example but if there are more than one cluster in the future please make sure you select the cluster you are interested in.
Once you are the logged in to the Rancher UI you will see a list of clusters, or just one, on the center of the screen like in the image below.
The cluster name is a link. Click on that to navigate to the Cluster Dashboard. Once on the Cluster Dashboard page there is a link to download the kubeconfig in the top right of the screen. The image below shows what the Download KubeConfig button looks like:
Click on that button and the cluster kubeconfig will be downloaded as
