Skip to content

Latest commit

 

History

History
137 lines (91 loc) · 5.26 KB

README.kustomize.md

File metadata and controls

137 lines (91 loc) · 5.26 KB

Deployment on Microk8s with Kustomize

⏱️ Time: installation within 25min

💻 Environment: tested on Ubuntu 20.04 LTS, 22.04 LTS, 24.04 LTS

MicroK8s is a lightweight, fast, and secure Kubernetes distribution designed for developers and edge computing use cases. Developed by Canonical, MicroK8s is a minimalistic version of Kubernetes that can be installed with a single command and runs on various platforms, including Linux, macOS, and Windows. It is ideal for local development, CI/CD pipelines, IoT, and edge deployments due to its small footprint and ease of use. MicroK8s includes essential Kubernetes components and add-ons, such as DNS, storage, and the Kubernetes dashboard, making it a convenient choice for both beginners and experienced Kubernetes users.

In this tutorial, we will guide you through the installation of the complete stack, which includes the Agent, Factory, Vault, and Hub. This setup enables the storage of recordings from multiple cameras at the edge, facilitating local data processing and ensuring secure and efficient management of video streams. To simplify our efforts we will execute the installation using Kustomize.

Install Microk8s

To install MicroK8s on your system, follow these steps. First, ensure that you have snapd installed on your machine. If not, you can install it using the following command:

To install MicroK8s on your system, follow these steps.

  1. Ensure that you have snapd installed on your machine. If not, you can install it using the following command:

    sudo apt update
sudo apt install snapd

  2. Install MicroK8s. Once snapd is installed, you can install MicroK8s with:

    sudo snap install microk8s --classic --channel=1.32/stable

  3. Add your user to the microk8s group. This step is necessary to avoid using sudo for MicroK8s commands:

    sudo usermod -a -G microk8s $USER
sudo chown -f -R $USER ~/.kube

  4. Apply the new group membership. You need to re-enter your session for the group change to take effect:

    su - $USER

  5. Check the status of MicroK8s. Ensure that MicroK8s is running correctly:

    microk8s status --wait-ready

  6. Add an alias for kubectl as microk8s:

To simplify the usage of kubectl with MicroK8s, you can create an alias. This allows you to use the kubectl command without needing to prefix it with microk8s. every time. Add the following line to your shell configuration file (e.g., .bashrc, .zshrc):

alias kubectl='microk8s kubectl'
alias helm='microk8s helm'

or use the snap command:

sudo snap alias microk8s.kubectl kubectl
sudo snap alias microk8s.helm helm

For more detailed instructions and troubleshooting, please refer to the official MicroK8s documentation.

Dependencies

When installing the Kerberos.io stack, several dependencies are required for storage, such as a database (e.g., MongoDB) and a message broker (e.g., RabbitMQ) for asynchronous behavior. We will install these components before setting up the Kerberos Agents and Kerberos Vault.

One of the key advantages of MicroK8s is its out-of-the-box addons, which can be enabled with a single command. This eliminates the need for complex Helm charts or operators, simplifying the setup process. We will enable some common services, such as DNS, GPU support, and storage, to streamline the installation.

microk8s enable dns
microk8s enable dashboard
microk8s enable nvidia
microk8s enable hostpath-storage

You can verify the status of the enabled addons by running the following command:

microk8s.status

Or view the pod status with:

kubectl get po -w -A

Clone repository

Next, we will clone this repository to our local environment. This will allow us to execute the necessary configuration files for installing the Minio operator, MongoDB Helm chart, and other required components.

git clone https://github.com/kerberos-io/deployment
cd deployment

Kustomize

In contrast to the detailed installation instructions, as mentioned here, an easier option to install is to use our Kustomize configure. This will allow you to specify and create your own overlays to install all the different components through a single command line.

kubectl kustomize overlays/microk8s/ --enable-helm --load-restrictor LoadRestrictionsNone | kubectl apply -f -

Cleanup

If you consider to remove the complete stack you might just disable the Microk8s installation

microk8s reset
sudo snap remove microk8s

or if you want to keep the Microk8s installation you can also delete the individual deployments.

kubectl delete -f data-filtering-deployment.yaml
kubectl delete -f kerberos-agent-deployment.yaml
kubectl delete -f ./kerberos-vault-deployment.yaml -n kerberos-vault
kubectl delete -f ./mongodb-config.yaml -n kerberos-vault
helm del rabbitmq -n rabbitmq
helm del mongodb -n mongodb
git clone --depth 1 --branch v6.0.1 https://github.com/minio/operator.git && kubectl delete -k operator/

You can confirm all the workloads were removed from your system.

kubectl get po -w -A