Home

Awesome

English | 简体中文

EdgeMesh

CI Go Report Card GitHub license

Introduction

EdgeMesh, as the data plane component of the KubeEdge cluster, provides simple service discovery and traffic proxy functions for applications, thereby shielding the complex network structure in edge scenarios.

Note: The KubeEdge-EdgeMesh data plane is not related in any way to edgemesh corporation or their e-commerce services. Their website is edgemesh.com.

Background

KubeEdge is build based on Kubernetes, extending cloud-native containerized application orchestration capabilities to the edge. However, at the scenario of edge computer, the network topology is more complex. Edge nodes in different areas are often not interconnected, and the inter-communication of traffic between applications is the primary requirement of the business. For this scenairo, EdgeMesh offers a solution.

Why EdgeMesh?

EdgeMesh satisfies the new requirements in edge scenarios (e.g., limited edge resources, unstable edge cloud network, complex network structure, etc.), that is, high availability, high reliability, and extreme lightweight:

User value

Key Features

<table align="center"> <tr> <th align="center">Feature</th> <th align="center">Sub-Feature</th> <th align="center">Realization Degree</th> </tr> <tr> <td align="center">Service Discovery</td> <td align="center">/</td> <td align="center">✓</td> </tr> <tr> <td rowspan="5" align="center">Traffic Governance</td> <td align="center">HTTP</td> <td align="center">✓</td> </tr> <tr> <td align="center">TCP</td> <td align="center">✓</td> </tr> <tr> <td align="center">Websocket</td> <td align="center">✓</td> </tr> <tr> <td align="center">HTTPS</td> <td align="center">✓</td> </tr> <tr> <td align="center">UDP</td> <td align="center">✓</td> </tr> <tr> <td rowspan="3" align="center">Load Balance</td> <td align="center">Random</td> <td align="center">✓</td> </tr> <tr> <td align="center">Round Robin</td> <td align="center">✓</td> </tr> <tr> <td align="center">Session Persistence</td> <td align="center">✓</td> </tr> <tr> <td rowspan="2" align="center">Edge Gateway</td> <td align="center">External Access</td> <td align="center">✓</td> </tr> <tr> <td align="center">Multi-NIC Monitoring</td> <td align="center">✓</td> </tr> <tr> <td rowspan="2" align="center">Cross-Subnet Communication</td> <td align="center">Cross-Cloud Communication</td> <td align="center">✓</td> </tr> <tr> <td align="center">Cross-LAN E2E Communication</td> <td align="center">✓</td> </tr> <tr> <td align="center">Edge CNI</td> <td align="center">Cross-Subnet Pod Communication</td> <td align="center">✓(beta)</td> </tr> </table>

Noting:

Architecture

image

After EdgeMesh v1.12.0, the capabilities of edgemesh-server are merged into the tunnel module of edgemesh-agent, so that edgemesh-agent with relay capability can automatically become a relay server, providing other nodes with the functions of assisting hole punching and relaying. Architecture before EdgeMesh v1.12.0

The core components of edgemesh-agent include:

Guides

Documents

Documentation is located on edgemesh.netlify.app. These documents can help you understand EdgeMesh better.

Installation

Follow the EdgeMesh installation document to install EdgeMesh.

Examples

Example1: HTTP traffic forwarding

Example2: HTTPS traffic forwarding

Example3: TCP traffic forwarding

Example4: Websocket traffic forwarding

Example5: UDP traffic forwarding

Example6: Load Balance

Example7: Cross-edge-cloud communication

Release

EdgeMesh is currently released with KubeEdge's main repo, and the released products will be placed in KubeEdge Releases. EdgeMesh's version release cadence will follow and be consistent with https://github.com/kubeedge/kubeedge.

Contact

If you need support, start with the 'Operation Guidance', and then follow the process that we've outlined

If you have any question, please contact us through the recommended information on KubeEdge

Contributing

If you are interested in EdgeMesh and would like to contribute to EdgeMesh project, please refer to CONTRIBUTING for detailed contribution process guide.