MiniKube

Minikube is a tool for running local Kubernetes clusters using Docker container “nodes”. Minikube was primarily designed for testing Kubernetes itself, but it can be used to deploy Kubernetes applications as well. To install or setup minikube, refer to the Minikube documentation

Requirements

minikube command line installed
docker Docker Engine installed
kubectl command-line tool must be configured to communicate with your cluster
openssl and curl command line must be installed too (only for install using kubectl)

Create minikube cluster

Run the command line to create

minikube start

You should read on stdout

😄  minikube v1.38.1 on Ubuntu 22.04
❗  minikube skips various validations when --force is supplied; this may lead to unexpected behavior
✨  Automatically selected the docker driver. Other choices: none, ssh
💡  If you are running minikube within a VM, consider using --driver=none:
📘    https://minikube.sigs.k8s.io/docs/reference/drivers/none/
❗  Starting v1.39.0, minikube will default to "containerd" container runtime. See #21973 for more info.
👍  Starting "minikube" primary control-plane node in "minikube" cluster
🚜  Pulling base image v0.0.50 ...
💾  Downloading Kubernetes v1.35.1 preload ...
    > preloaded-images-k8s-v18-v1...:  272.45 MiB / 272.45 MiB  100.00% 37.62 M
    > gcr.io/k8s-minikube/kicbase...:  519.58 MiB / 519.58 MiB  100.00% 25.65 M
🔥  Creating docker container (CPUs=2, Memory=3900MB) ...
🐳  Preparing Kubernetes v1.35.1 on Docker 29.2.1 ...
🔗  Configuring bridge CNI (Container Networking Interface) ...
🔎  Verifying Kubernetes components...
    ▪ Using image gcr.io/k8s-minikube/storage-provisioner:v5
🌟  Enabled addons: storage-provisioner, default-storageclass
🏄  Done! kubectl is now configured to use "minikube" cluster and "default" namespace by default

Run the install bash script

curl -sL https://raw.githubusercontent.com/abcdesktopio/conf/main/kubernetes/install-4.4.sh |bash

show details

[INFO] abcdesktop install script namespace=abcdesktop
[OK] kubectl version
[OK] openssl version
[OK] kubectl create namespace abcdesktop
writing RSA key
writing RSA key
[OK] abcdesktop_jwt_desktop_payload keys create
writing RSA key
[OK] abcdesktop_jwt_desktop_signing keys create
writing RSA key
[OK] abcdesktop_jwt_user_signing keys create
[OK] create secret generic abcdesktopjwtdesktoppayload
[OK] create secret generic abcdesktopjwtdesktopsigning
[OK] create secret generic abcdesktopjwtusersigning
[OK] label secret abcdesktopjwtdesktoppayload
[OK] label secret abcdesktopjwtdesktopsigning
[OK] label secret abcdesktopjwtusersigning
[OK] mongod key file create
######################################################################## 100.0%
[OK] downloaded source https://raw.githubusercontent.com/abcdesktopio/conf/main/kubernetes/abcdesktop-4.4.yaml
######################################################################## 100.0%
[OK] downloaded source https://raw.githubusercontent.com/abcdesktopio/conf/main/reference/od.config.4.4
[OK] kubectl create configmap abcdesktop-config --from-file=od.config -n abcdesktop
[OK] label configmap abcdesktop-config abcdesktop/role=pyos.config
[OK] default account is created
[OK] role.rbac.authorization.k8s.io/pyos-role created
rolebinding.rbac.authorization.k8s.io/pyos-rbac created
serviceaccount/pyos-serviceaccount created
configmap/version-config created
configmap/configmap-mongodb-scripts created
secret/secret-mongodb created
configmap/abcdesktop-passwd-templatefile created
configmap/abcdesktop-group-templatefile created
configmap/abcdesktop-shadow-templatefile created
configmap/abcdesktop-gshadow-templatefile created
statefulset.apps/mongodb-od created
deployment.apps/memcached-od created
deployment.apps/router-od created
deployment.apps/nginx-od created
deployment.apps/speedtest-od created
deployment.apps/pyos-od created
deployment.apps/console-od created
deployment.apps/openldap-od created
service/desktop created
service/memcached created
service/mongodb created
service/speedtest created
service/pyos created
service/console created
service/http-router created
service/website created
service/openldap created
[OK] pyos-serviceaccount account is created
[INFO] waiting for deployment/console-od available
[OK] deployment.apps/console-od condition met
[INFO] waiting for deployment/memcached-od available
[OK] deployment.apps/memcached-od condition met
[INFO] waiting for deployment/nginx-od available
[OK] deployment.apps/nginx-od condition met
[INFO] waiting for deployment/openldap-od available
[OK] deployment.apps/openldap-od condition met
[INFO] waiting for deployment/pyos-od available
[OK] deployment.apps/pyos-od condition met
[INFO] waiting for deployment/router-od available
[OK] deployment.apps/router-od condition met
[INFO] waiting for deployment/speedtest-od available
[OK] deployment.apps/speedtest-od condition met
[INFO] waiting for pod/console-od-7789497dcf-d24rb Ready
[OK] pod/console-od-7789497dcf-d24rb condition met
[INFO] waiting for pod/memcached-od-54cdf9d684-rsqkg Ready
[OK] pod/memcached-od-54cdf9d684-rsqkg condition met
[INFO] waiting for pod/mongodb-od-0 Ready
[OK] pod/mongodb-od-0 condition met
[INFO] waiting for pod/nginx-od-6bf5fd7c7-54k7p Ready
[OK] pod/nginx-od-6bf5fd7c7-54k7p condition met
[INFO] waiting for pod/openldap-od-5c4646dc7f-bjsh9 Ready
[OK] pod/openldap-od-5c4646dc7f-bjsh9 condition met
[INFO] waiting for pod/pyos-od-6f88895f4d-g4cdm Ready
[OK] pod/pyos-od-6f88895f4d-g4cdm condition met
[INFO] waiting for pod/router-od-647b77455d-nk677 Ready
[OK] pod/router-od-647b77455d-nk677 condition met
[INFO] waiting for pod/speedtest-od-7d7c95d754-dmt5j Ready
[OK] pod/speedtest-od-7d7c95d754-dmt5j condition met
[INFO] list all pods in namespace abcdesktop
NAME                            READY   STATUS    RESTARTS   AGE
console-od-7789497dcf-d24rb     1/1     Running   0          4m38s
memcached-od-54cdf9d684-rsqkg   1/1     Running   0          4m38s
mongodb-od-0                    2/2     Running   0          4m38s
nginx-od-6bf5fd7c7-54k7p        1/1     Running   0          4m38s
openldap-od-5c4646dc7f-bjsh9    1/1     Running   0          4m38s
pyos-od-6f88895f4d-g4cdm        1/1     Running   0          4m38s
router-od-647b77455d-nk677      1/1     Running   0          4m38s
speedtest-od-7d7c95d754-dmt5j   1/1     Running   0          4m38s
[INFO] Setup done
[INFO] Checking the service url on http://localhost:30443
[INFO] service status is down
[INFO] Looking for a free tcp port from 30443
[OK] get a free tcp port from 30443

[INFO] If you're using a cloud provider
[INFO] Forwarding abcdesktop service for you on port=30443
[INFO] For you setup is running the command 'kubectl port-forward router-od-647b77455d-nk677 --address 0.0.0.0 30443:80 -n abcdesktop'
[OK] Please open your web browser and connect to

[INFO] http://192.168.7.119:30443/

How to connect ?

The install bash script forward the tcp port 30443 to the router pod port tcp 80

kubectl port-forward router-od-647b77455d-nk677 --address 0.0.0.0 30443:80 -n abcdesktop

[OK] Please open your web browser and connect to

[INFO] http://192.168.7.119:30443/

Open the URL returnes by the install bash script. In this sample http://192.168.7.119:30443/ Change the ip address 192.168.7.119 with your own

kind home page

Your web browser shows the abcdesktop service home page

kind user connected

The user Philip J. Fry is connected to the abcdesktop service

Open the URL returnes by the install bash script. In this sample http://192.168.7.119:30443/

Great you have installed abcdesktop using kind and your web browser shows the abcdesktop service.

Delete cluster

To uninstall, run the minikube delete cluster command line:

minikube delete

Common issues

issue 'FailedScheduling 0/1 nodes are available'

FailedScheduling 0/1 nodes are available: 1 Insufficient cpu. preemption: 0/1 nodes are available: 1 No preemption victims found for incoming pod

To fix it, start minikube with enough cpu and memory resources to start all abcdesktop's pods and the user's desktop

minikube start --cpus 4 --memory 16GB