Retrieve Kubeconfig

You need to provide the kubeconfig of a member cluster if you import it using direct connection. For clusters that are already connected to the console, users granted the platform-admin role can also open the kubeconfig entry from the Tools card on the cluster Overview page.

Prerequisites

You need a Kubernetes cluster and the permission to read its kubeconfig.

Open the kubeconfig page from the console

1. Log in to Kube AI Hub with a user granted the platform-admin role.

2. Go to Platform > Cluster Management, and open the Overview page of the target cluster.

3. In the Tools card, click kubeconfig.

4. View, copy, or download the kubeconfig content from the page that opens.

Retrieve kubeconfig from a Kubernetes node

For a member cluster that is about to be imported, the kubeconfig is commonly available at $HOME/.kube/config on a control plane or administration node. Use the following command to print the raw kubeconfig:

kubectl config view --raw

apiVersion: v1
clusters:
- cluster:
    certificate-authority-data: <certificate-authority-data>
    server: https://lb.kube-ai-hub.local:6443
  name: cluster.local
contexts:
- context:
    cluster: cluster.local
    user: kubernetes-admin
  name: kubernetes-admin@cluster.local
current-context: kubernetes-admin@cluster.local
kind: Config
preferences: {}
users:
- name: kubernetes-admin
  user:
    client-certificate-data: <client-certificate-data>
    client-key-data: <client-key-data>

Use kubeconfig during cluster import

1. In the Kube AI Hub console, choose to import the member cluster through Direct connection.

2. Paste or upload the kubeconfig content as prompted by the page.

3. Make sure the API server address in the server field is reachable from the host cluster.

4. Submit the import task and wait for the cluster status to update.