document how to run this chart in minikube on MacOS

[wkloucek]

We couldn't get it running without #106

On Linux I need https://minikube.sigs.k8s.io/docs/handbook/addons/ingress-dns/ or #106 to be able to log in.

[case0sh]

Steps to use oCIS with minikube on mac (arm64/amd64)

Regarding this issue: The ingress and ingress-dns add-ons are currently only supported on Linux. See kubernetes/minikube#7393

Install dependencies

brew cask install docker
brew install minikube

Start minikube

➜  minikube start
😄  minikube v1.31.2 on Darwin 13.4 (arm64)
✨  Automatically selected the docker driver
📌  Using Docker Desktop driver with root privileges
👍  Starting control plane node minikube in cluster minikube
🚜  Pulling base image ...
❗  minikube was unable to download gcr.io/k8s-minikube/kicbase:v0.0.40, but successfully downloaded docker.io/kicbase/stable:v0.0.40 as a fallback image
🔥  Creating docker container (CPUs=2, Memory=4000MB) ...
🐳  Preparing Kubernetes v1.27.4 on Docker 24.0.4 ...
    ▪ Generating certificates and keys ...
    ▪ Booting up control plane ...
    ▪ Configuring RBAC rules ...
🔗  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

Mac requires additional configurations
Add domain name to hosts

##
# Host Database
#
# localhost is used to configure the loopback interface
# when the system is booting.  Do not change this entry.
##
127.0.0.1       ocis.kube.owncloud.test # domain example

127.0.0.1       localhost
255.255.255.255 broadcasthost
::1             localhost

Add ingress addon to minikube

➜ minikube addons enable  ingress
💡  ingress is an addon maintained by Kubernetes. For any concerns contact minikube on GitHub.
You can view the list of minikube maintainers at: /~https://github.com/kubernetes/minikube/blob/master/OWNERS
💡  After the addon is enabled, please run "minikube tunnel" and your ingress resources would be available at "127.0.0.1"
    ▪ Using image registry.k8s.io/ingress-nginx/controller:v1.8.1
    ▪ Using image registry.k8s.io/ingress-nginx/kube-webhook-certgen:v20230407
    ▪ Using image registry.k8s.io/ingress-nginx/kube-webhook-certgen:v20230407
🔎  Verifying ingress addon...
🌟  The 'ingress' addon is enabled

Start minikube tunnel

➜ minikube tunnel
✅  Tunnel successfully started

📌  NOTE: Please do not close this terminal as this process must stay alive for the tunnel to be accessible ...

❗  The service/ingress proxy requires privileged ports to be exposed: [80 443]
🔑  sudo permission will be asked for it.
🏃  Starting tunnel for service proxy.
Password:

[wkloucek]

What I do on Linux:

• minikube start --addons=ingress,ingress-dns
• https://minikube.sigs.k8s.io/docs/handbook/addons/ingress-dns/#installation -> 4) (optional) Configure in-cluster DNS server to resolve local DNS names inside cluster is mandatory in our case
• add entries to /etc/hosts
• install oCIS

[wkloucek]

@case0sh we need to expose hostAliases as configuration for Mac users and add that to your oCIS install step

[wkloucek]

will be continued in owncloud/docs-ocis#621