Complete the minikube tutorial

[wangkuiyi]

The Running PaddlePaddle Cloud on Minikube tutorial doesn't explain how to verify the successful configuration of the minikube cluster.

I'd thought that we could follow this tutorial when we develop PaddlePaddle Cloud; however, it doesn't explain how to do the development work with minikube.

[wangkuiyi]

Prerequisites

• install minikube
• install kubectl

This section should be a step, not a section.

We only need the first of the two external links; it contains the second link.

[wangkuiyi]

https_proxy=https://YOURPROXY:PORT minikube start --kubernetes-version v1.6.4

We need to explain why we need 1.6.4. here, if we do need this specific version; or, let's explain that any recent version works, or so.

[wangkuiyi]

  mkdir <yourpath>

• mac
  Since Minikube mounts $Home path by default, we recommend creating the path under $Home which offers the flexibility of switching between directories in your deployment without stopping the MiniKube and mounting another one.
• linux
  Mount path manually:

  minikube mount <yourpath>:<yourpath>

This step is very lengthy and confusing. I tried to rewrite it something like the following:

mkdir $HOME/workspace

If we are running Mac OS X, minikube would automatically mount $HOME to virtual machines. If we are running Linux, we need to mount manually:

minikube mount $HOME:$HOME

[wangkuiyi]

cp ~/.minikube/ca.crt . cp ~/.minikube/ca.key .

How/where comes the directory ~/.minikube?

[wangkuiyi]

kubectl create -f cloud_ingress.yaml

How comes / where is cloud_ingress.yaml?

[wangkuiyi]

Edit ~/.paddle/config like this:

into

Edit the configuration file of paddlectl, ~/.paddle/config:

[wangkuiyi]

username: password:

What should be the and ?

[wangkuiyi]

You can use PaddlePaddle Cloud command line now.

How to use it? We need an example here to verify that the minikube cluster was successfully set up.

[wangkuiyi]

FAQ

into

Troubleshooting

[putcn]

got it, I will update the doc.

[gongweibao]

@putcn https://github.com/PaddlePaddle/cloud/pull/463#issuecomment-342353141

[putcn]

i'm having issue while trying to follow this tutorial.

1. looks v1.6.4 is no longer supported by minikube 0.25(the latest)
2. my kubectl is not able to connect to api server created by minikube in Mac, with the following error

   Unable to connect to the server: dial tcp 192.168.99.100:8443: i/o timeout

   did some research, but no solution yet. @gongweibao is minikube working in your Mac?

[gongweibao]

If you are in China, without proxy we can't download minikube's dependency successful.

Do you use

https_proxy=https://YOURPROXY:PORT minikube start --kubernetes-version v1.6.4

And then we should open a new terminal with no global https_proxy set and kubectl will succeed after the command upper.