[docs] Add some notes about installing consul-helm in local k8s cluster

[soonoo]

How about adding some tips about installing consul-helm in local kubernetes cluster?

[hashicorp-cla]

All committers have signed the CLA.

[jsosulska]

Hi @soonoo

Apologies on the long tail on the response, and thank you for opening this. I'd like to offer some feedback.

This call out looks good. Have you tried running a helm values.yml file with only server.replica:1? This should provide you an appropriately configured dev cluster, like the example outlined in our Minikube guide. I would also recommend making the call out in the Customizing your Installation section.

As an addition - if there is a specific error being output, either by Consul or Kubernetes, and your recommendation fixes that error, I would add it to the troubleshooting section.

Let me know if there's anything I can help with, and thank you again for the contribution!
Best,
Jono

[soonoo]

Hi @jsosulska.
Thank you for response.

I just typed installation commands in Installing Consul on Kubernetes page. At that time, I expected it to succeed without any customization.
However since my k8s cluster has only one worker node, installation with default values.yml failed while printing error message. Error message was about the failure to elect a leader. It took a while to figure out that I needed to fix server.replicas or to increase worker nodes.

I'm not using Minikube so didn't notice that comment about server.replicas is in Minikube guide.

It would be nice if it was added to the troubleshooting sectionr, but I'm not sure.(Since it is not common to have only one worker node)

[jsosulska]

Hi @soonoo

Apologies for the incredibly long tail on this response. During the interim, we've updated all of our Kubernetes guides, as well as our website. Rather than have you rebase, I've added you on #10293 as a co-author. I used the basis of your request to point to all of our learn guides, as those have individual deployment caveats. I hope this will be more clear :)

Thank you for the request, and for your patience!

[soonoo]

@jsosulska Thank you for reflecting my request!