gopaddle User Guide
  • 👋Welcome to gopaddle
  • Overview
    • 💡Getting Started
    • Register a Cluster
      • Register Rancher Prime - RKE2
      • Register K3S
      • Register MicroK8s
      • Register Kind
      • Register minikube
      • Register Kubeadm Cluster
      • Register AWS EKS Cluster
        • EKS Cluster with public or public/private access point
        • EKS Cluster with private access endpoint and a bastion host
        • Validate Cluster Connectivity
      • Register Azure AKS Cluster
      • Register Google GKE Cluster
      • Register Huawei Cloud Container Engine
    • Register GitHub Account
    • Register Jira Account
    • Register ChatGPT Assistant
    • 💻Kubernetes IDE
      • Filters
      • Editor
      • Flat vs Tree View
      • Developer Tools
    • 🙋AI Assistant
      • Chat with AI
      • Raise a Jira Ticket from Chat Window
      • Create Runbook from Chat Window
    • 📖Runbook Hub
      • Create Runbook Hub
      • Attach Runbook Hub to Cluster
      • Enhancing contents of Runbooks with AI
      • Detach Runbook Hub from Cluster
      • Syncing Runbook Hub with GitHub
      • Delete Runbook / Runbook Hub
    • ⏱️Installing Community Edition
      • MicroK8s Addon
        • On Ubuntu
        • On MacOS
      • Docker Desktop
      • SUSE Rancher Prime
      • Digital Ocean
      • Akamai Linode
      • Kind Cluster
      • Helm
      • Docker Compose
      • Accessing gopaddle UI
    • 📈Improving performance of resource discovery
    • Provision new Cluster
      • Register Cloud Account
        • AWS
          • Quickstart AWS Setup
          • IAM Access Policies
          • AWS Setup Script
        • Azure
          • Create Azure Application
          • Register Azure Cloud Authenticator
          • Register Azure Account
        • Google
      • Provision Clusters on Cloud
        • AWS EKS
          • AWS EKS Reference Architecture
          • Adding an AWS IAM Role (EKS Master / Node Pool)
          • Public EKS Cluster
          • All Private EKS Cluster (beta)
          • Creating a Node Pool
        • Azure AKS
          • Creating a Node Pool
          • Enable Public IP Node Access for Azure Deployments
          • VMSS Autoscaling Rules
        • Google GKE
          • Creating a Node Pool
  • 🔎Troubleshooting
    • Cluster Resource View Issues
      • Network Error ! ServerError: Response not successful: Received status code 503
      • Network Error ! TypeError: Failed to fetch
      • Network Error ! ServerParseError: Unexpected token 'j', "json: erro"... is not valid JSON
      • Updating Labels and Annotations does not get reflected in resources list
      • Filtered resources are not fully listed
    • Runbook Issues
      • Deleting a runbook from .gp.yaml does not detach annotation in resources
      • Deleting a Code Account from gopaddle UI does not detach annotation in resources
    • Jira Issues
      • Creating, Updating or Appending a Jira issue fails with error INVALID_INPUT
    • EKS Issues
    • Deployment Issues
    • Node Issues
    • Huawei Issues
Powered by GitBook
On this page
  1. Overview
  2. Register a Cluster

Register Kubeadm Cluster

Steps to register a Cluster provisioned by kubeadm in gopaddle

PreviousRegister minikubeNextRegister AWS EKS Cluster

Last updated 1 year ago

  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: .

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: .

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.

  1. Verify if Kubernetes configuration works

export KUBECONFIG=<path to kubeconfig>
kubectl config view
  1. In the gopaddle UI, navigate to the Clusters section

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

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

  4. Choose the Cluster Provider type as Other

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

  6. 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.

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

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

Page cover image
Adding a name to Kubernetes API server certificate
Adding a name to Kubernetes API server certificate
troubleshooting
Upload the Kubeconfig file
Provide the Bastion Host Connection Details