Skip to content

Commit

Permalink
Chinese doc: install in VM (#3004)
Browse files Browse the repository at this point in the history
* Add dsw link for some doc

* update dock link

* Add interactive example example section in doc

* Chinese doc: install in VM

* modify install_sqlflow_vm_box.cn.md

* update title

* modify doc
  • Loading branch information
lhw362950217 authored Oct 15, 2020
1 parent 878462c commit 1dc7b4a
Showing 1 changed file with 42 additions and 0 deletions.
42 changes: 42 additions & 0 deletions doc/sqlflow.org_cn/install_sqlflow_vm_box.cn.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
# 安装 SQLFlow VM Box

## 安装
SQLFlow 的运行依赖大量的组件,我们已经将这些依赖打包到一个虚拟机镜像中,用户只需要安装该镜像
即可快速体验 SQLFlow 功能。请参考以下步骤进行安装:

1. 安装 [VirtualBox](https://www.virtualbox.org/wiki/Downloads) (推荐v6.1.6版本)
1. 下载预制的 SQLFlow 镜像,这里你有两个选择:
* 精简版(600M),在这个版本中,我们预置了 SQLFlow 的基础环境和启动脚本,但不包含运行
所需的 Docker 镜像,首次启动的时候需要拉取镜像。镜像下载地址为:

```url
http://cdn.sqlflow.tech/latest/SQLFlowPlaygroundBare.ova
```
* 完整版(2G),这个版本包含 SQLFlow 所需的所有依赖,只需下载一次即可运行。镜像下载地址为:

```url
http://cdn.sqlflow.tech/latest/SQLFlowPlaygroundFull.ova
```

1. 启动 VirtualBox,点击”管理->导入虚拟机“菜单,选择下载的 `.ova` 文件,将下载好的镜像导入到
VirtualBox 中,双击导入的镜像启动虚拟机。
1. 虚拟机启动后,在窗口中输入账号和密码,默认为(root/sqlflow)来登录。登录后你将看到一个
start.bash 脚本,运行它即可启动 SQLFlow 系统。如果你熟悉 shell 工具,也可以通过以下命令
来登录。
```
ssh -p2222 [email protected]
[email protected]'s password: sqlflow
./start.bash
```
1. 运行启动脚本后会看到一系列日志,当出现 `Access Jupyter NoteBook at: http://127.0.0.1:8888/...`
类似的提示时,表示系统已经启动,此时在浏览器上输入该链接,即可访问到 SQLFlow 用户界面,你可以选择
其中的例子来运行。
## 常见问题
1. Docker 镜像下载速度慢
建议更换 Docker 镜像源,或者下载完整版(运行时无需再下载镜像)
1. start.bash 脚本异常退出
通常是由于下载 Docker 镜像超时引起,重新启动该脚本即可
1. 脚本正常退出,但无法访问 web 界面
通常由于容器尚在启动中,重新运行 start.bash 即可

0 comments on commit 1dc7b4a

Please sign in to comment.