user avatar
Merge pull request #3581 from moolen/fix/metrics-func
KubeEdge Bot authored
fix: add missing metrics func
9a7e140b
Name Last commit Last update
.github verify go version when call build.sh script
CHANGELOG add v1.9 changelog link
LICENSES replace github.com/satori/go.uuid with github.com/google/uuid
build Fix-3585 pv's objectsync spec.ObjectKind is empty
cloud Merge pull request #3599 from neiba/objectsync-kind-empty
common update k8s version to v1.21.8
docs Update keadm-scope.md
edge Merge pull request #3581 from moolen/fix/metrics-func
edgemesh remove edgemesh from edgecore
edgesite replace deprecated package io/ioutil with packages io and os
hack Merge pull request #3530 from gy95/crossimage
keadm use testing.TempDir to create temp directory
mappers remove mappers from kubeedge/kubeedge repo
pkg use testing.TempDir to create temp directory
staging/src/github.com/kubeedge Merge pull request #3413 from ankitrgadiya/fix/send-sync-anon-channel
tests add official latest version keadm e2e
vendor Merge pull request #3392 from mjlshen/sqlite3
.gitignore add .vscode directory to gitignore
.golangci.yml enable golangci-lint for codes under staging
.travis.yml update golang to 1.16
ADOPTERS.md change ictnj format svg
CHANGELOG.md add release note for v1.9
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md
CONTRIBUTING.md Fixed: broken links
LICENSE Initial commit
MAINTAINERS
MAINTAINERS.md
Makefile
OWNERS
README.md
README_zh.md
external-dependency.md
go.mod
go.sum

KubeEdge

Build Status Go Report Card LICENSE Releases Documentation Status

English | 简体中文

KubeEdge is built upon Kubernetes and extends native containerized application orchestration and device management to hosts at the Edge. It consists of cloud part and edge part, provides core infrastructure support for networking, application deployment and metadata synchronization between cloud and edge. It also supports MQTT which enables edge devices to access through edge nodes.

With KubeEdge it is easy to get and deploy existing complicated machine learning, image recognition, event processing and other high level applications to the Edge. With business logic running at the Edge, much larger volumes of data can be secured & processed locally where the data is produced. With data processed at the Edge, the responsiveness is increased dramatically and data privacy is protected.

KubeEdge is an incubation-level hosted project by the Cloud Native Computing Foundation (CNCF). KubeEdge incubation announcement by CNCF.

Note:

The versions before 1.6 have not been supported, please try upgrade.

Advantages

  • Kubernetes-native support: Managing edge applications and edge devices in the cloud with fully compatible Kubernetes APIs.
  • Cloud-Edge Reliable Collaboration: Ensure reliable messages delivery without loss over unstable cloud-edge network.
  • Edge Autonomy: Ensure edge nodes run autonomously and the applications in edge run normally, when the cloud-edge network is unstable or edge is offline and restarted.
  • Edge Devices Management: Managing edge devices through Kubernetes native APIs implemented by CRD.
  • Extremely Lightweight Edge Agent: Extremely lightweight Edge Agent(EdgeCore) to run on resource constrained edge.

How It Works

KubeEdge consists of cloud part and edge part.

Architecture

In the Cloud

  • CloudHub: a web socket server responsible for watching changes at the cloud side, caching and sending messages to EdgeHub.
  • EdgeController: an extended kubernetes controller which manages edge nodes and pods metadata so that the data can be targeted to a specific edge node.
  • DeviceController: an extended kubernetes controller which manages devices so that the device metadata/status data can be synced between edge and cloud.

On the Edge

  • EdgeHub: a web socket client responsible for interacting with Cloud Service for the edge computing (like Edge Controller as in the KubeEdge Architecture). This includes syncing cloud-side resource updates to the edge, and reporting edge-side host and device status changes to the cloud.
  • Edged: an agent that runs on edge nodes and manages containerized applications.
  • EventBus: a MQTT client to interact with MQTT servers (mosquitto), offering publish and subscribe capabilities to other components.
  • ServiceBus: a HTTP client to interact with HTTP servers (REST), offering HTTP client capabilities to components of cloud to reach HTTP servers running at edge.
  • DeviceTwin: responsible for storing device status and syncing device status to the cloud. It also provides query interfaces for applications.
  • MetaManager: the message processor between edged and edgehub. It is also responsible for storing/retrieving metadata to/from a lightweight database (SQLite).

Kubernetes compatibility

Kubernetes 1.15 Kubernetes 1.16 Kubernetes 1.17 Kubernetes 1.18 Kubernetes 1.19 Kubernetes 1.20 Kubernetes 1.21
KubeEdge 1.7
KubeEdge 1.8
KubeEdge 1.9
KubeEdge HEAD (master)

Key:

  • KubeEdge and the Kubernetes version are exactly compatible.
  • + KubeEdge has features or API objects that may not be present in the Kubernetes version.
  • - The Kubernetes version has features or API objects that KubeEdge can't use.

Guides

Get start with this doc.

See our documentation on kubeedge.io for more details.

To learn deeply about KubeEdge, try some examples on examples.

Roadmap

Meeting

Regular Community Meeting:

Resources:

Contact

If you need support, start with the troubleshooting guide, and work your way through the process that we've outlined.

If you have questions, feel free to reach out to us in the following ways:

Contributing

If you're interested in being a contributor and want to get involved in developing the KubeEdge code, please see CONTRIBUTING for details on submitting patches and the contribution workflow.

License

KubeEdge is under the Apache 2.0 license. See the LICENSE file for details.