Skip to content

Set up your very own IEM 2.0 instance on a Kubernetes cluster using K3s

License

Notifications You must be signed in to change notification settings

industrial-edge/iem-on-k3s

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Industrial Edge Management on K3s

Industrial Edge Management System can be installed on any compliant Kubernetes (K8s) cluster.
This documentation describes the complete installation process of IEM 2.0 on K3s distribution.

Description

Overview

Industrial Edge Management deployed in K3s cluster.

General Task

The objective of this tutorial is to provide a comprehensive walkthrough for users on the setup process of IEM 2.0 on a Kubernetes cluster. To achieve this, a new Kubernetes cluster will be established utilizing the K3s framework, and subsequently, the IEM service will be deployed within it. By the conclusion of this tutorial, users will have successfully created and onboarded a new IEM instance, which will be fully prepared for utilization within the Industrial Edge Ecosystem.

General architecture overview General architecture overview

Requirements

Prerequisites

  • Industrial Edge Hub (IEH) Access
  • Powerful host PC or server with Internet access
    With a minimum of:
    • 4 (v)CPU cores
    • 16 GB of RAM
    • 100 GB of HDD Space
  • Linux-based operating system

Network Requirements

To ensure the successful onboarding of a new Industrial Edge Management (IEM) instance, it is imperative that the host machine possess an active internet connection and the capability to access IE Hub domains. If your host machine operates within a proxy or firewall environment, it is essential to ensure that all necessary domains are appropriately whitelisted. Please refer to the "Industrial Edge - Security Overview" document for further guidance.

Used components

  • K3s - Kubernetes distribution - v1.27.3+k3s1
  • IEM - Industrial Edge Management - v1.2.24
  • ieprovision - Industrial Edge Provisioning CLI - Ubuntu - v1.0.8

Installation

To deploy Industrial Edge Management on a K3s cluster, you must perform the following tasks:

Usage

After successfully following all the installation steps, you will have a fully operational instance of IEM (Industrial Edge Management) deployed within a local Kubernetes (K3s) cluster. This instance is now ready to be utilized within the Industrial Edge Ecosystem. For comprehensive guidance on operating the IEM instance, please consult the official Industrial Edge Documentation - Industrial Edge Management - Operation.

Documentation

You can find further documentation and help at the following links:

Contribution

Thank you for your interest in contributing. Anybody is free to report bugs, unclear documentation, and other problems regarding this repository in the Issues section. Additionally everybody is free to propose any changes to this repository using Pull Requests.

If you haven't previously signed the Siemens Contributor License Agreement (CLA), the system will automatically prompt you to do so when you submit your Pull Request. This can be conveniently done through the CLA Assistant's online platform. Once the CLA is signed, your Pull Request will automatically be cleared and made ready for merging if all other test stages succeed.

License and Legal Information

Please read the Legal information.