superedge

README

English | 简体中文

SuperEdge

---

👋 Now SuperEdge v0.9.0 has supported Kins feature, which will provision lightweighted K3s cluster on edge NodeUnit and you can play it totally offline. Welcome to checkout and try edgeadm

---

What is SuperEdge?

SuperEdge is an open source container management system for edge computing to manage compute resources and container applications in multiple edge regions. These resources and applications, in the current approach, are managed as one single Kubernetes cluster. A native Kubernetes cluster can be easily converted to a SuperEdge cluster.

SuperEdge has the following characteristics:

• Kubernetes-native: SuperEdge extends the powerful container orchestration and scheduling capabilities of Kubernetes to the edge. It makes nonintrusive enhancements to Kubernetes and is fully compatible with all Kubernetes APIs and resources. Kubernetes users can leverage SuperEdge easily for edge environments with minimal learning.

• Edge autonomy: Now SuperEdge provides L4/L5 edge autonomy.

  L3: When the network connection between the edge and the cloud is unstable, or the edge node is offline, the node can still work independently. But at this time, edge node can't do anything associated with writing operation, such as create/delete/update.

  L4/L5: Now SuperEdge has released v0.9.0 which support Kins Feature. Kins will provision a lightweight K3s cluster based on SuperEdge, which can be operated totally offline. L4 level will leverage the single master edge K3s cluster, and L5 level will provision 3 master edge K3s cluster.

• Distributed node health monitoring: SuperEdge provides edge-side health monitoring capabilities. SuperEdge can continue to monitor the processes on the edge side and collect health information for faster and more accurate problem discovery and reporting. In addition, its distributed design can provide multi-region monitoring and management.

• Built-in edge orchestration capability: SuperEdge supports automatic deployment of multi-regional microservices. Edge-side services are closed-looped, and it effectively reduces the operational overhead and improves the fault tolerance and availability of the system.

• Network tunneling: SuperEdge ensures that Kubernetes nodes can operate under different network situations. It supports network tunnelling using TCP, HTTP, HTTPS and SSH.

SuperEdge was initiated by the following companies: Tencent, Intel, VMware, Huya, Cambricon, Captialonline and Meituan.

Architecture

Cloud components:

• tunnel-cloud: Maintains a persistent network connection to tunnel-edge services. Supports TCP/HTTP/HTTPS network proxies.
• application-grid controller: A Kubernetes CRD controller as part of ServiceGroup. It manages DeploymentGrids, StatefulSetGrids and ServiceGrids CRDs and control applications and network traffic on edge worker nodes.
• edge-health admission: Assists Kubernetes controllers by providing real-time health check status from edge-health services distributed on all edge worker nodes.
• site-manager: A Kubernetes CRD controller which will manipulate NodeUnitand NodeGroup. And this controller is also responsible for Kins feature.

Edge components:

• lite-apiserver: Lightweight kube-apiserver for edge autonomy. It caches and proxies edge components' requests and critical events to cloud kube-apiserver.
• edge-health: Monitors the health status of edge nodes in the same edge region.
• tunnel-edge: Maintains persistent connection to tunnel-cloud to retrieve API requests to the controllers on the edge.
• application-grid wrapper: Managed by application-grid controller to provide independent internal network space for services within the same ServiceGrid.

Quickstart Guide

Please refer to the sub-project edgeadm. If you want to bring up a SuperEdge cluster from scrath, check this manual One-click install of edge Kubernetes cluster.

• Download the installation package

  The supported version:

  • CPU arch [amd64, arm64], kubernetes version [1.22.6], version: v0.9.0

  • CPU arch [amd64, arm64], kubernetes version [1.22.6, 1.20.6], version: v0.8.2

  arch=amd64 version=v0.9.0 kubernetesVersion=1.22.6 && rm -rf edgeadm-linux-* && wget https://superedge-1253687700.cos.ap-guangzhou.myqcloud.com/$version/$arch/edgeadm-linux-$arch-$version-k8s-$kubernetesVersion.tgz && tar -xzvf edgeadm-linux-* && cd edgeadm-linux-$arch-$version-k8s-$kubernetesVersion && ./edgeadm
  

• Install edge Kubernetes master node

  ./edgeadm init --kubernetes-version=1.22.6 --image-repository superedge.tencentcloudcr.com/superedge --service-cidr=10.96.0.0/12 --pod-network-cidr=192.168.0.0/16 --install-pkg-path ./kube-linux-*.tar.gz --apiserver-cert-extra-sans=<Master Public IP> --apiserver-advertise-address=<Master Intranet IP> --enable-edge=true --edge-version=0.9.0
  

• Join edge node

  ./edgeadm join <Master Public/Intranet IP Or Domain>:Port --token xxxx --discovery-token-ca-cert-hash sha256:xxxxxxxxxx --install-pkg-path <edgeadm kube-* install package address path> --enable-edge=true
  

Other installation, deployment, and administration, see our Tutorial.

More details

• tutorial_CN

Contact

For any question or support, feel free to contact us via:

• Join #SuperEdge Slack channel (Need to join CNCF Slack first)
• Join SuperEdge Discussion Forum
• Meeting agenda and notes
• Join WeChat Group Discussion

Contributing

Welcome to contribute and improve SuperEdge

Troubleshooting and Feedback

If you encounter any failure in the process of using SuperEdge, you can use Contact Contact us, or give us feedback via Troubleshooting and Feedback.

License

Apache License 2.0