Problems found when following "Local Kubernetes Development Guide"

[yosheeck]

Summary:
This is list of problems found when strictly following "Local Kubernetes Development Guide" (https://mojaloop.io/documentation/deployment-guide/) with corresponding actions to fix them.

Severity:
Low

Priority:
Low

Expected Behavior
Following the Guide should be straightforward.

Steps to Reproduce

1. Follow "Local Kubernetes Development Guide" strictly on Linux machine.

Specifications

• Component (if known): *
• Version: version exposed as "current", so v8.1.0
• Platform: Linux
• Subsystem: *
• Type of testing: manual
• Bug found/raised by: @yosheeck

Notes:

• Severity when opened:
• Priority when opened:

Details:

• Installation of microk8s at the moment (2019-11-04) defaults to version v1.16 of kubernetes. Current helm charts for mojaloop (v8.1.0) are not compatible. Last supported version is v1.15. Kubernetes explanation: https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG-1.16.md#deprecations-and-removals.
  • Action: add note in documentation to install <=v1.15 for mojaloop <=v8.3.0
• Step 4.1 "helm init" may fail with ambiguous message (Error: error installing: Post http://localhost:8080/apis/apps/v1/namespaces/kube-system/deployments: dial tcp 127.0.0.1:8080: connect: connection refused) when .kube/config file is missing.
  • Action: add note about generating that file.
• Pods/services fail to start when one of the needed microk8s plugin is not enabled.
  Action: add a step to ensure that mandatory services are enabled on microk8s.
• Troubleshooting: add a section about looking at output of microk8s.inspect. Example warning about missing "sudo iptables -P FORWARD ACCEPT".
• Postman golden path issue found. The default value of HOST_SIMULATOR_K8S_CLUSTER parameter in Mojaloop-Local environment seems to wrong
  • change configs for postman
• Documentation->Releases needs updating: https://mojaloop.io/documentation/deployment-guide/releases.html
  • discussed that with @elnyry - not doing this as part of this ticket
• In latest snap documentation, they removed "alias" section. Our documentation relies on that part. I reported a ticket on microk8s: New docs: alias section removed canonical/microk8s.io#172

Pull Requests:

• Fix for Postman environment: Updated HOST_SIMULATOR_K8S_CLUSTER for local env postman#63
• Onboarding docs fixes: Update onboarding docs in context of issue #1046 documentation#130