How to install IoT Edge on Kubernetes (Preview)

Applies to: yes icon IoT Edge 1.1

IoT Edge can integrate with Kubernetes using it as a resilient, highly available infrastructure layer. Here is where this support fits in a high level IoT Edge solution:

k8s intro


A good mental model for this integration is to think of Kubernetes as another operating environment IoT Edge applications can run on in addition to Linux and Windows.


On Kubernetes, IoT Edge provides Custom Resource Definition (CRD) for edge workload deployments. IoT Edge Agent assumes the role of a CRD controller that reconciles cloud-managed desired state with the local cluster state.

Module lifetime is managed by the Kubernetes scheduler, which maintains module availability and chooses their placement. IoT Edge manages the edge application platform running on top, continuously reconciling the desired state specified in IoT Hub with the state on the edge cluster. The application model is still the familiar model based on IoT Edge modules and routes. The IoT Edge Agent controller performs automatic translation IoT Edge's application model to the Kubernetes native constructs like pods, deployments, services etc.

Here is a high-level architecture diagram:

kubernetes arch

Every component of the edge deployment is scoped to a Kubernetes namespace specific to the device, making it possible to share the same cluster resources among multiple edge devices and their deployments.


IoT Edge on Kubernetes is in public preview.

Tutorials and references

Please see the IoT Edge on Kubernetes preview docs mini-site for more information, including in-depth tutorials and references.