Create and Manage a ZEDEDA Edge Kubernetes Service Cluster Using the GUI

Updated

Introduction

A ZEDEDA Edge Kubernetes Service cluster is the “engine” for running a set of one or more interconnected edge nodes that work together to run containerized applications. It differs from an Edge Node Cluster, which is primarily for high availability (HA) and data replication purposes.

This is a series of articles. You will likely follow them in this order.

  1. ZEDEDA Edge Kubernetes Service and ZEDEDA Edge Kubernetes App Flows Overview 
  2. Create and Manage ZEDEDA Edge Kubernetes Service and App Flows using the API
  3. Create and Manage a ZEDEDA Edge Kubernetes Service Cluster Using the GUI - You are here!
  4. Manage an App from the ZEDEDA Edge Kubernetes App Flows Marketplace Using the GUI 
  5. Manage ZEDEDA Edge Kubernetes App Flows Installed Applications Using the GUI
  6. Create and Manage ZEDEDA Edge Kubernetes App Flows Cluster Groupings Using the GUI
  7. Create ZEDEDA Edge Kubernetes App Flows GitOps Repositories Using the GUI
  8. Troubleshoot ZEDEDA Edge Kubernetes Service and App Flows

Prerequisites

  • You have onboarded one or more edge nodes.
  • Your edge nodes are in the same project.
  • Your edge nodes are online. 
  • Your edge nodes are running the EVE-k v16.0.0 or greater (EVE-OS KVM is not supported).
  • For installation, we recommend all the edge nodes be of the same hardware type/model with a minimum of 12 core CPUs, 16 GB RAM, and NVMe SSDs for EVE persistent storage for optimal performance. 
  • For runtime, EVE-k consumes approximately 4 GB of memory and 2 vCPUs if used for clustering.
  • It recommended, though not strictly required, to separate the management traffic from the cluster traffic. 
  • You have either the SysManager or SysAdmin role in your ZEDEDA Cloud enterprise.
  • This feature is enabled through feature flags. CSadmin level access is required to enable and disable feature flags. 

Enable the ZEDEDA Edge Kubernetes Service Feature

Your edge nodes are running the EVE-k image (EVE-OS KVM is not supported).

The kubernetes solution is enabled through feature flags. CSadmin level access is required to enable and disable feature flags. There are two levels of control to enable the feature flags:

  • Root - This is the base feature configuration. If the feature is disabled here, it's disabled across all child enterprises.

  • Child - This for the specific enterprise. If root is enabled only then child enterprise is allowed to enable/disable the feature. The kubernetes solution can be enabled in a child enterprise, only if it is enabled in the parent enterprise.

To enable the feature on ZEDEDA Cloud, the Kubernetes Orchestration feature flag is available as part of entitlements. You need to login as a CSadmin > go to entitlements > go to the required enterprise details and enable the flag. After it is enabled, you can login into the enterprise and check the same.

Add a ZEDEDA Edge Kubernetes Service Cluster

You cannot add an edge node to a cluster if an application instance is running on it. 

  1. Click on Edge Kubernetes > Clusters in the left panel.
  2. Click the Add icon at the top right of your page.
  3. Continue on to the configuration sections as needed, such as configure the Edge Kubernetes Cluster Configuration. 
  4. Click Add when finished.

Configure the ZEDEDA Edge Kubernetes Service Cluster Configuration

  1. Enter the cluster Name.
    This is unique across the enterprise and cannot be changed.
  2. Enter the cluster Title.
    This value is not used by the ZEDEDA Cloud system. It’s offered to give you more flexibility in organizing your enterprise. It can be changed after you create the object. 
  3. Enter a Description to help other admins understand the purpose of the cluster or any important details.
  4. Enter Tags to help you group and identify clusters based on specific criteria. For example, you could tag them with key:value pairs such as “group-environment:production” or “group-criticality:high” or “group-location:us-west”.  By using the same tags when you create your Edge Kubernetes Clusters, you can then select those tags to group multiple clusters together based on specific criteria like environment ("environment-group:production") or location ("location-group:us-west") and then manage them as a single entity when you manage installed applications or create a Cluster Grouping.
  5. Click Next. 

Configure the Edge Node Configuration

  1. Select the cluster Project that contains your edge nodes.
  2. Enter Edge Node Tags: If you created a tag when you onboarded your edge node, you can enter it here as a filter. Do not try to create a new key:value pair here or you will not find your edge node.  
  3. Enter Edge Node Network Adapter Tags: If you created a tag when you created your network instance, you can enter it here as a filter. Do not try to create a new key:value pair here or you will not find your network. 
  4. Select the checkbox for one, three, or more edge nodes that you want to join together into a cluster. 
    • A cluster can’t consist of two edge nodes, it needs an odd number for quorum. 
    • An edge node that already belongs to a cluster can’t be added to another cluster. 
  5. For each edge node, select the Network Adapter that you configured during onboarding your edge nodes. This is the adapter that is used for routing to the other cluster nodes. 
  6. Click Next.

Review and Create the ZEDEDA Edge Kubernetes Service Cluster

  1. Review the details for identity, edge node selection, and cluster network.
  2. Click Add.
  3. The ZEDEDA GUI shows the cluster as created, but it takes a few minutes for the job to complete.
  4. View the status of the Edge Kubernetes Cluster.

View all ZEDEDA Edge Kubernetes Service Clusters

After you create ZEDEDA Edge Kubernetes Service Clusters, you can view them all.

  1. Select Edge Kubernetes > Clusters from the left panel.
  2. Observe the list of your Edge Kubernetes Clusters.

Name The name of the Edge Kubernetes Cluster. Click the name to see the Cluster Dashboard.
Status

The status of the Edge Kubernetes Cluster.

  • Init
  • Unprovisioned
  • Provisioned
  • Online
  • Offline
Kubernetes Version The version of Kubernetes running on the cluster
No. of Edge Nodes The number of edge nodes in the Edge Kubernetes Cluster. Select from the drop-down to Add Edge Node or Remove Edge Node from the cluster. 
Project The project that the cluster belongs to.
Drawer

Get a quick overview of the following: 

  • Provider
  • Kubernetes Version
  • Architecture
  • Created
  • Total Resources
  • Nodes
  • Deployments
  • Capacity
    • Pods
    • CPUs
    • Memory

Also Add Edge Node or Remove Edge Node from the cluster (as long as you have one or three or more remaining nodes). 

View One ZEDEDA Edge Kubernetes Service Cluster

After you create ZEDEDA Edge Kubernetes Service Clusters, you can view the details of the individual cluster.

  1. Select Edge Kubernetes > Clusters from the left panel.
  2. Observe the list of your Edge Kubernetes Clusters.
  3. Click the Name of a provisioned or online Edge Kubernetes Cluster of interest.
  4. You can see the following in the dashboard:
    • Cluster
    • Workloads
    • Service Discovery
    • Storage
    • Policy

Add an Edge Node to ZEDEDA Edge Kubernetes Service

After you add a ZEDEDA Edge Kubernetes Service Cluster, you can add edge nodes to it.

  1. Select Edge Kubernetes > Clusters from the left panel.
  2. From the No. of Edge Nodes column or from the Drawer, select Add Edge Node.
  3. The display shows the edge nodes available in the project.
  4. Select one or more edge nodes to add to the cluster. 
  5. Select a Network Adapter that you configured during onboarding your edge nodes. This is the adapter that is used for routing to the other cluster nodes and to ZEDEDA Cloud. 
  6. Enter existing Edge Node Tags.
  7. Enter existing Edge Node Network Adapter Tags. 
  8. Click Add. 

Remove an Edge Node from ZEDEDA Edge Kubernetes Service

After you add a ZEDEDA Edge Kubernetes Service Cluster and add edge nodes to it, you can remove edge nodes from it (as long as you have one or three or more remaining nodes).

  1. Select Edge Kubernetes > Clusters from the left panel.
  2. From the No. of Edge Nodes column or from the Drawer, select Remove Edge Node.
  3. The display shows the edge nodes available in the project.
  4. Select one or more edge nodes to remove from the cluster. 
  5. Click Remove. 

Delete the ZEDEDA Edge Kubernetes Service Cluster

After you add a ZEDEDA Edge Kubernetes Service Cluster you can delete it if you no longer need it. You cannot delete an edge node from an Edge Kubernetes Cluster if an application instance is running on it. 

  1. From the left panel, go to Edge Kubernetes > Clusters.
  2. Click the checkboxes next to one or more clusters that you want to delete.
  3. Click the ellipsis (...) at the top right of the page.
  4. Select Delete from the drop-down.
  5. Confirm the action.

Watch the Video

Next Steps

This is a series of articles. You will likely follow them in this order.

  1. ZEDEDA Edge Kubernetes Service and ZEDEDA Edge Kubernetes App Flows Overview 
  2. Create and Manage ZEDEDA Edge Kubernetes Service and App Flows using the API
  3. Create and Manage a ZEDEDA Edge Kubernetes Service Cluster Using the GUI - You are here!
  4. Manage an App from the ZEDEDA Edge Kubernetes App Flows Marketplace Using the GUI 
  5. Manage ZEDEDA Edge Kubernetes App Flows Installed Applications Using the GUI
  6. Create and Manage ZEDEDA Edge Kubernetes App Flows Cluster Groupings Using the GUI
  7. Create ZEDEDA Edge Kubernetes App Flows GitOps Repositories Using the GUI
  8. Troubleshoot ZEDEDA Edge Kubernetes Service and App Flows

 

Was this article helpful?
0 out of 0 found this helpful