Edge infrastructure preparation¶
ICOS supports only containerized environments and applications. To onboard edge infrastructure into ICOS, you must choose between the following options:
- Installation of a Kubernetes cluster.
- Installation of Docker Engine.
While this guide does not provide detailed instructions for installing Kubernetes (refer to the kubernetes official documentation) or Docker (refer to the docker official documentation), we offer an example of how to install K3s on a device with a single command below. Depending on your choice, you can execute the corresponding commands for a basic setup that will enable you to continue with the onboarding process.
Kubernetes¶
One of the easiest ways to setup a basic ICOS-valid Kubernetes environment is via the K3S installation script and the installation of Helm (Kubernetes package manager).
-
Launch a new K3S cluster:
-
Install Helm:
Any Kubernetes + Helm setup with Kubernetes version 1.19 or higher will work for ICOS. K3S is just simple and quick example.
Docker¶
You can quickly install the Docker Engine using the commands below (taken from the official Docker documentation for Ubuntu):
-
Make sure any old installations are removed.
-
Set up Docker's apt repository.
**Add Docker's official GPG key:**
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
**Add the repository to Apt sources:**
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
- Install the Docker packages
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
- (Optional) To run docker commands without prefacing them with sudo everytime
After this , you can go to the next step : Install the Orchestrator