Install MicroK8s offline (deprecated)

This document details the procedure to install MicroK8s on an offline machine.

Prerequisites

Please ensure that the installation of MicroK8s is performed on a machine that meets the technical requirements.

Get required files

  1. Connect via SSH on a machine with the same operating system as the machine where Cyberwatch will be deployed. This machine must be connected to the internet.

  2. Create the sources directory:

    mkdir microk8s_sources; cd microk8s_sources

  3. Download the packages:

    1. On a Red Hat based distribution:

      1. Install yum-utils:

        sudo yum install yum-utils curl epel-release

      2. Download snapd and its dependencies:

        sudo yumdownloader --resolve snapd

      3. Install snapd:

        sudo yum install snapd

      4. Install podman:

        sudo yum install podman
export CONTAINER_DOWNLOADER=podman

    2. On a Debian-based distribution:

      1. Download dependencies of package snapd:

        This command downloads the whole dependency tree to ensure that the installation will work on the offline machine.

        apt-get download $(apt-cache depends --recurse --no-recommends --no-suggests \
   --no-conflicts --no-breaks --no-replaces --no-enhances \
   --no-pre-depends snapd | grep "^\w")

      2. Install snapd

        sudo apt install snapd

      3. Install docker:

        sudo apt install docker.io
export CONTAINER_DOWNLOADER=docker

  4. Download the container images required by MicroK8s:

    sudo $CONTAINER_DOWNLOADER pull docker.io/calico/cni:v3.13.2
sudo $CONTAINER_DOWNLOADER pull docker.io/calico/pod2daemon-flexvol:v3.13.2
sudo $CONTAINER_DOWNLOADER pull docker.io/calico/kube-controllers:v3.13.2
sudo $CONTAINER_DOWNLOADER pull docker.io/calico/node:v3.13.2
sudo $CONTAINER_DOWNLOADER pull docker.io/coredns/coredns:1.6.6
sudo $CONTAINER_DOWNLOADER pull k8s.gcr.io/pause:3.1

sudo $CONTAINER_DOWNLOADER save docker.io/calico/cni:v3.13.2                -o cni.tar
sudo $CONTAINER_DOWNLOADER save docker.io/calico/pod2daemon-flexvol:v3.13.2 -o pod2daemon.tar
sudo $CONTAINER_DOWNLOADER save docker.io/calico/kube-controllers:v3.13.2   -o kube-controllers.tar
sudo $CONTAINER_DOWNLOADER save docker.io/calico/node:v3.13.2               -o node.tar
sudo $CONTAINER_DOWNLOADER save docker.io/coredns/coredns:1.6.6             -o coredns.tar
sudo $CONTAINER_DOWNLOADER save k8s.gcr.io/pause:3.1                        -o pause.tar

  5. Download snap packages for microk8s and helm:

    sudo snap download core
sudo snap download microk8s --channel=1.20/stable

sudo snap download core18
sudo snap download helm --channel=3.5/stable

  6. Archive all the files:

    cd ..
sudo tar czvf microk8s_sources.tar.gz microk8s_sources

Install MicroK8s

  1. Transfer the archive on the offline machine

  2. Switch to the root user:

    sudo su

  3. Extract the sources:

    tar xvzf microk8s_sources.tar.gz
cd microk8s_sources

  4. Install snapd:

    1. On a Red Hat based distribution:

      yum install *.rpm

    2. On a Debian-based distribution:

      dpkg -i *.deb

  5. Enable and start snapd and snap’s classic mode:

    systemctl enable snapd --now
ln -s /var/lib/snapd/snap /snap

  6. Install microk8s and helm:

    ls *.assert | xargs -n 1 snap ack
ls *.snap | xargs -n 1 snap install --classic

  7. Start MicroK8s:

    /snap/bin/microk8s start

  8. Load the images into MicroK8s:

    ls *.tar| xargs -n 1 -I {} /snap/bin/microk8s ctr i import $(pwd)/{}

Back to top