Minikube QuickStart Guide Feedback

[tiago-maia]

Hello Everyone :)

This post is an improvement suggestion based on what was my point of view as someone new trying to implement the quick start guide for minikube and the issues that i had to solve that the guide did not specifiy. (https://microservices-demo.github.io/deployment/kubernetes-minikube.html)

1. If we use minikube with only one node (default use case i think ?) elastic by default will not work because of the bootstrap cheks, need to switch for dev mode
   i added this env variable in the elasticsearch.yaml

env:
    - name: discovery.type
      value: single-node`

2. The image version for the containers in elasticsearch.yaml and kibana.yaml does not work by default needed to change to elasticsearch: 7.12.1 and kibana: 7.12.1 respectively.

3. Depending on the kubernetes version being used by minikube the apiVersion for fluentd-cr.yaml and fluentd-crb.yaml may be deprecated (v 1.22 above is deprecated and need to be changed to apiVersion: rbac.authorization.k8s.io/v1 )

4. The tutorial mentions that after i deploy the manifests for logging i should be able to access the kibana dashboard.
   "You should be able to see the Kibana dashboard at http://192.168.99.100:31601."
   But that is not true for everyone. You need to create a tunnel to be able to access the service by opening a new shell and using minikube service {service-name} . or in my case when we are using the docker driver on Windows it needs to use port-forward of the kibana pod using kubectl port-forward {Kibana-pod-name} -n kube-system 5601:5601 and with that i was able to access the dashboard.
   (More info on the topic here Pod not accessible on NodePort via the Windows 10 host machine. kubernetes/minikube#9499)

5. The command kubectl create -f deploy/kubernetes/manifests/sock-shop-ns.yaml has the wrong path since the file for the namespace is currently named 00-sock-shop-ns.yaml

6. Point 4 is repeated to access the sockShop itself has the service is a NodePort as well.

Hope it is clear, any doubts or different opinions please feel free to discuss 👍

[lkrumpak]

This little guide is great as of May 2023.
However, one more minor change is needed before you run the command in Step 5

Within "deploy/kubernetes/manifests/03-carts-db-dep.yaml" and "deploy/kubernetes/manifests/13-orders-db-dep.yaml"

Use an older mongo image. Such as mongo:5.0.11. Otherwise the cart and older pods will produce errors.

[webbasedToast]

The same issue with the mongo image can/should also be applied, if you are using the complete-demo.yaml (the alterations should be added in the lines 94 and 408 of the yaml-file).

Also i found that the : combinations also work, if the address gotten from the minikube ip command is used instead of the 192.168.99.100 one.