Creating a Kubernetes Cluster with Hostspace Kubernetes Engine (HKE)

Welcome to HostSpaceNG’s Managed Kubernetes on Virtual Machines (VMs). This guide will help you set up and manage your Kubernetes clusters using our platform. Our goal is to empower organizations with the ability to streamline container orchestration, enhance agility, and deliver exceptional business value.

Step 1: Create VM Instances (Nodes) for the Cluster

In this step, you will create the virtual machine (VM) instances that will serve as nodes in your Kubernetes cluster.

  1. Choose a Cloud Provider: You can create a virtual machine (VM) on any cloud provider like GCP, AWS, Azure, or local providers such as Nobus. Ensure that the VM meets the system requirements for running Kubernetes.

  2. Connect to SSH: During the VM creation, associate it with an SSH key that will allow secure access to the VM.

  3. Configure Ports:

    • Ensure the following ports are open to facilitate communication within your Kubernetes cluster:

      • Common Ports:

        • 22 (SSH): For secure shell access.

        • 16443 and 8443: For Kubernetes API server communications.

        • 10250-10255: For kubelet communications, crucial for management tasks and health checks within the cluster.

      • Additional Ports for HA Setup:

        • 19001 and 25000: These ports need to be open on all nodes to allow them to join a Highly Available (HA) cluster.

      • Port for Non-HA Setup:

        • 25000: This port needs to be open on all nodes in a Non-HA cluster setup.

      • Port for Pod DNS Resolutions:

        • 4789 (UDP): This port needs to be open and restricted to the node instances. This is required by the pods for its DNS resolution.

      • Port for Pod DNS Resolutions:

        • 4443 (UDP): This port needs to be open on all nodes needed to export NetData metrics to user's HKE Dashboard.

Basic Inputs for VM Creation on Nobus:

  • Name: KubeTestVM

  • Availability Zone: nova

  • Machine Type: (1 vCPU, 2 GB RAM) — sufficient for basic tests

  • Operating System: Ubuntu 22.04 LTS

  • Networking: Default settings; ensure ports 22, 80, and 443 are open.

Step 2: Accessing HKE Interface

  1. Navigate to HKE: Open your browser and head over to ui.hostspaceng.com. Select deploy with Managed Kubernetes. To read more about deploying with managed containers, click here.

Step 3: Create a Kubernetes Cluster

In this step, you will use the Hostspace Kubernetes Engine (HKE) interface to create your Kubernetes cluster.

  1. Input Cluster Details:

    • Instance IP: Enter the public IP address(es) of the VM instance(s) you created. If you have multiple IPs, separate them using a comma, enter key, or tab key.

    • Private SSH Key: Paste the private SSH key associated with the VM(s).

    • Cluster Name: Enter a name for your Kubernetes cluster.

    • Username: Provide the username that matches the SSH username used in accessing the instance.

  1. Create Cluster: After filling out the details, click the 'Create Cluster' button to initiate the cluster provisioning.

Step 4: Connect to the Kubernetes Cluster

Once the cluster is created, you will get redirected to a page where you can view information about your Kubernetes cluster, add or delete nodes etc

You can connect to the cluster by clicking on the connect to the cluster button

  1. Download kubeconfig File: Once the cluster is created, download the kubeconfig file from the HKE interface. This file is necessary to connect to your Kubernetes cluster.

  2. Connect Using kubectl:

    • Open a terminal on your computer.

    • Use the command to verify connectivity to your Kubernetes cluster.

    kubectl --kubeconfig=path_to_your_kubeconfig_file get nodes

Congratulations! You have successfully set up your Kubernetes cluster with HostSpaceNG’s HKE. You are now ready to deploy and manage applications in a scalable and highly available environment.

Troubleshooting and Support

If you encounter any issues during the setup or management of your cluster, please refer to our troubleshooting guide for detailed instructions and FAQs. If your issue persists, our support team is here to help:

  • Email: admin@hostspaceng.com

Read our Troubleshooting Guide for step-by-step solutions, diagnostic tools, and more.\

Feedback

We continuously strive to improve our services and user experience. Please provide us with feedback on how we can enhance this guide or any other services.

Feedback form.

\

\

Last updated