Run PaddleCloud on minikube. #463
Conversation
gongweibao
requested review from
Yancey1989,
helinwang,
putcn and
typhoonzero
doc/run_on_minikube.md
Outdated
| # Run PaddleCloud on your local machine | ||
|
|
||
| This documentation shows how to run PaddleCloud on minikube. | ||
| (This surports only mac now.On unbuntu-16.04,we met a bug of kubernetes when we use `hostpath` to volume a file.) |
There was a problem hiding this comment.
"Currently, This guide works with Mac OS only. On Ubuntu 16.04, the bug for Kubernetes to mount a single file with hostpath is a show stopper"
also, do we have a link for this bug in kubernetes repo?
There was a problem hiding this comment.
kubernetes/kubernetes#44815 (comment)
can this help solve the issue?
There was a problem hiding this comment.
OK, I will test it later.
Thanks!
There was a problem hiding this comment.
It's amazing to find that we can volume a file on Linux now!
doc/run_on_minikube.md
Outdated
| If you can't connect to minikube distribution server,add https_proxy like that: | ||
|
|
||
| ```bash | ||
| https_proxy=<your's> minikube start --kubernetes-version v1.6.4 |
doc/run_on_minikube.md
Outdated
| ``` | ||
| mkdir <yourpath> | ||
| ``` | ||
| Minikube mount `$Home` path default,and you'd better to create path under it or you may find that it can't be changed in minikube virtual mathine or in kubertes pod. |
There was a problem hiding this comment.
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.
doc/run_on_minikube.md
Outdated
| Minikube mount `$Home` path default,and you'd better to create path under it or you may find that it can't be changed in minikube virtual mathine or in kubertes pod. | ||
|
|
||
| 1. Copy `ca` and generate `admin` certificate： | ||
| (We must use `ca` under `~/.minikube` instead of under `~/.minikube/certs`.) |
There was a problem hiding this comment.
We must use ca under ~/.minikube rather than ~/.minikube/certs.
doc/run_on_minikube.md
Outdated
| cp ~/.minikube/ca.key . | ||
| ``` | ||
|
|
||
| 1. Copy and configure paddlecloud configures: |
There was a problem hiding this comment.
Copy and update paddlecloud configurations:
doc/run_on_minikube.md
Outdated
| kubectl create -f pfs_service.yaml | ||
| kubectl create -f cloud_deployment.yaml | ||
| ``` | ||
| 1. Type `$(minikube ip)` into browser,and sign up a user. |
There was a problem hiding this comment.
open cloud.testpcloud.org in your browser and sign up a user.
doc/run_on_minikube.md
Outdated
|
|
||
| ## FAQ | ||
| 1. We can't get anything when we type `$(minikube ip)` into browser. | ||
| You can use `minikube get po --all-namespaces` to check it,it should like: |
There was a problem hiding this comment.
One possible cause is: default-http-backend is not ready yet. Run minikube get po --all-namespaces to check its status.
If it's stuck at pulling the image, one alternative is to manually download the image and load it with minikube's docker.
- run
kubectrl describe po name --namespace=kube-systemto get docker image uri. docker save <docker-image-uri> > <tarname>.tarto save the image to a tar file. You may need to use proxy with this step- 'minikube ssh' to login to Minikube's command line
docker load < <tarname>.tarto load the image to Kubenetes' local docker image repo
doc/run_on_minikube.md
Outdated
| - `minikube ssh`. | ||
| - `docker load < <tarname>.tar`. | ||
|
|
||
| 1. I edit a file,but it not change in minikube virtual machine some times. |
doc/run_on_minikube.md
Outdated
| - `minikube ssh`. | ||
| - `docker load < <tarname>.tar`. | ||
|
|
||
| 1. I edit a file,but it not change in minikube virtual machine some times. |
There was a problem hiding this comment.
I edited a file in host file system, but it remained unchanged in Minikube virtual machine sometimes.
doc/run_on_minikube.md
Outdated
| - `docker load < <tarname>.tar`. | ||
|
|
||
| 1. I edit a file,but it not change in minikube virtual machine some times. | ||
| Ye, it seems that minikube has a cache of files.You'd better `minikube stop` `minikube start --kubernetes-version v1.6.4` to fix it. |
There was a problem hiding this comment.
That might be due to the files cache mechanism of Minikube. You can try to restart the Minikube with minikube stop minikube start --kubernetes-version v1.6.4 to fix it.
doc/run_on_minikube.md
Outdated
|
|
||
| ## TODO | ||
| 1. The `mysql` docker runs `mysqld` under user `mysql` instead of `root`,so it's difficult to save `mysql` data to hostpath. | ||
| 1. Fix bug: `kubernetes can't mount a file use host to volume a file` on linux. |
There was a problem hiding this comment.
Kubernetes can't mount the volume with hostpath to a single file
|
Setup paddle cloud on Kubernetes have so many steps, it would be great if you create a vagrant image containing pre-configured paddle cloud. |
|
It's a very useful idea. This will be done in the next PR. @typhoonzero |
|
Thanks very much! @putcn |
|
Add a new ISSUE:#497 |
Fix #418