Register Kubeadm Cluster

Steps to register a Cluster provisioned by kubeadm in gopaddle

1. Fetch the Kubernetes config file

2. Prepare the Kubernetes config file to register the cluster in gopaddle.

If you don't have a Bastion Host setup and the server value in your Kubernetes config points to a private IP address, do the following:

a) Change the server value to a publicly accessible Cluster API Endpoint. b) Verify that the firewall allows traffic through the Cluster API port (usually 6443 or 16443). c) Check that the Cluster certificate includes the public IP address. This guide explains how to update the certSANs with the public IP: Adding a name to Kubernetes API server certificate.

If you don't have a Bastion Host setup and the server value in your Kubernetes config points to a domain name, make sure there is a DNS entry that correctly resolves the cluster name.If you don't have a Bastion Host setup and the server value in your Kubernetes config points to a private IP address, do the following:

a) Change the server value to a publicly accessible Cluster API Endpoint. b) Verify that the firewall allows traffic through the Cluster API port (usually 6443 or 16443). c) Check that the Cluster certificate includes the public IP address. This guide explains how to update the certSANs with the public IP: Adding a name to Kubernetes API server certificate.

If you don't have a Bastion Host setup and the server value in your Kubernetes config points to a domain name, make sure there is a DNS entry that correctly resolves the cluster name.

2. Verify if Kubernetes configuration works

export KUBECONFIG=<path to kubeconfig>
kubectl config view

3. In the gopaddle UI, navigate to the Clusters section

4. Click on Add a Cluster and select Register an existing Cluster

5. In the Cluster registration wizard, select the Cluster Access Method as Kube Config

6. Choose the Cluster Provider type as Other

7. In the Authentication Step, upload the Kubernetes config file gathered in step 1.

   

   Upload the Kubeconfig file

8. If you have configured a bastion host, provide the Bastion Host IP, SSH Pem file, SSH port

   If you are using a Bastion Host setup, make sure the Bastion Host IP and Port are accessible publicly. If you are looking for a private only setup, get in touch with us to explore gopaddle Enterprises.

   

   Provide the Bastion Host Connection Details

9. Click on Finish to register the On-premises Cluster.

10. If you see the error - Network Error ! ServerError: Response not successful: Received status code 503, while view the cluster resources, then check this troubleshooting section for more information.