[GitHub] csantanapr closed pull request #219: minikube doc improvement: configuration commands

[GitBox <gi...@apache.org>]

csantanapr closed pull request #219: minikube doc improvement: configuration commands
URL: https://github.com/apache/incubator-openwhisk-deploy-kube/pull/219
 
 
   

This is a PR merged from a forked repository.
As GitHub hides the original diff on merge, it is displayed below for
the sake of provenance:

As this is a foreign pull request (from a fork), the diff is supplied
below (as it won't show otherwise due to GitHub magic):

diff --git a/docs/minikube.md b/docs/minikube.md
index 3d9ad6e..a7fe4f8 100644
--- a/docs/minikube.md
+++ b/docs/minikube.md
@@ -59,13 +59,22 @@ asdf install minikube 0.25.2
 asdf global minikube 0.25.2
 ```
 
-## Create the minikube VM
+## Configure the Minikube VM
+
 You will want at least 4GB of memory and 2 CPUs for Minikube to run OpenWhisk.
 If you have a larger machine, you may want to provision more (especially more memory).
 
-Start Minikube with:
 ```
-minikube start --cpus 2 --memory 4096 --kubernetes-version=v1.9.0 --extra-config=apiserver.Authorization.Mode=RBAC
+minikube config set kubernetes-version v1.9.0
+minikube config set cpus 2
+minikube config set memory 4096
+minikube config set WantUpdateNotification false
+```
+
+## Start Minikube
+
+```
+minikube start --extra-config=apiserver.Authorization.Mode=RBAC
 ```
 
 ## Setup Docker network in promiscuous mode
@@ -74,8 +83,21 @@ Put the docker network in promiscuous mode.
 minikube ssh -- sudo ip link set docker0 promisc on
 ```
 
+**Tip**: Make sure to setup the Docker network after `minkube start` if you ran `minkube delete` as this configuration will be lost.
+
 Your Minikube cluster should now be ready to deploy OpenWhisk.
 
+## Changing Kubernetes versions
+
+To use a different version of Kubernetes with Minikube, you need to delete the VM, reconfigure minikube, restart, and
+redo the setup of the Docker network.
+```
+minikube delete
+minikube config set kubernetes-version <NEW_VERSION>
+minikube start --extra-config=apiserver.Authorization.Mode=RBAC
+minikube ssh -- sudo ip link set docker0 promisc on
+```
+
 # Troubleshooting
 
 For some combinations of Minikube and Kubernetes versions, you may need to workaround a [Minikube DNS issue](https://github.com/kubernetes/minikube/issues/2240#issuecomment-348319371). A common symptom of this issue is that the OpenWhisk couchdb pod will fail to start with the error that it is unable to resolve `github.com` when cloning the openwhisk git repo. A work around is to delete the minikube cluster, issue the command `minikube config set bootstrapper kubeadm` and then redo the `minikube start` command above.


 

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services