vnpy/docker/README.md

83 lines
3.6 KiB
Markdown
Raw Normal View History

2017-04-26 13:26:46 +00:00
# VNPY 的 Docker 镜像
author:[@lamter](https://github.com/lamter)
> _关于Docker_
> - _`Docker` 是基于 `Linux`的一个服务。通过模拟了整个 `Linux`的系统文件,来实现沙盒,所以`Docker`不是虚拟机,更类似于在`Linux`中模拟`Windows`的`Wine`。_
> - _在`Linux`中,`Docker`可以直接运行在宿主中,而在`Mac`和`Windows`中,是通过`VirtualBox`等先建立一个`Linux`的虚拟机,然后再在这个虚拟机中运行`Docker`。这样的话可能会有些许差异,比如`--host`的与宿主共享网络的模式。_
> - _在`Linux`系统下,模式下会使得`Docker`的容器与宿主共享网络端口,但是在`Mac`或者`Windows`中,该模式是容器与虚拟机中的`Linux`共享网络端口,而不是直接跟宿主`Mac`或者`Windows`共享端口。_
1. 使用 docker 镜像来提供运行和编译环境。
2. 将策略打包到 docker 镜像中以便直接在生产环境部署。
3. Docker教程看[这里](https://yeasy.gitbooks.io/docker_practice/content/)。
4. Docker加速看[这里](https://www.daocloud.io/mirror#accelerator-doc)
## 制作环境镜像
### 制作环境镜像
在`docker/`目录下运行:
```bash
➜ user@master~/vnpy/docker: bash build_image.sh
...
Successfully built fb3ae4d5e0eb
```
漫长的等待后之后,查看
```bash
➜ user@master~/vnpy/docker: docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
vnpy latest fb3ae4d5e0eb 21 minutes ago 856 MB
ubuntu 16.04 4ca3a192ff2a 4 weeks ago 128.2 MB
```
vnpy 的运行环境镜像 `vnpy:latest` 制作成功。
`ubuntu` 镜像是用于构建 `vnpy` 镜像的上层镜像。之后可以使用 `vnpy` 镜像继续构建下层镜像,用于生产环境的部署。
### 测试运行
在`docker/`目录下运行
```bash
➜ user@master~/vnpy/docker: bash run_shell.sh
➜ root@docker/: 进入镜像
```
只是使用 `vnpy` 镜像启动了一个容器,并使用了`bash`来进行交互。此时环境基本上跟使用命令行登陆一台`Linux`类似。
查看`run_shell.sh`脚本可知,已经将整个`vnpy`的项目路径映射到了容器内的`/srv/vnpy`路径。
### 尝试编译
由于是一个新的```Linux```环境,```CTP```之类的接口需要重新编译。
```bash
➜ root@docker/: cd /srv/vnpy/vn.ctp
➜ root@docker/: ./build.sh
...
[100%] Built target vnctpmd
...
```
编译完成后,通过`Git`可以看到新编译成的`*.so`之类的文件。需要注意的是,此时对`/srv/vnpy`路径下的改动,也会反映到宿主下的`vnpy`项目。
**也就意味着当前项目下的CTP接口已经被镜像中的编译包替换了。**
### 启动`vnpy`
在`vn.trader/ctpGateway/CTP_connection.json`中配置CTP链接账号的服务器host。
尝试启动 vnpy 实例
```bash
➜ root@docker /: cd /srv/vnpy/vn.trader
➜ root@docker docker: python vtServer.py
...
vn.trader服务器已启动
请输入exit来关闭服务器
```
运行成功。
### 直接运行项目代码
目前由于未知的原因,直接在宿主中通过传递命令的方式(见`vn.docker/server_vnpy.sh`脚本)来直接启动服务,会使得服务阻塞。所以目前只能先通过`run_shell.sh`脚本进入容器交互中,再启动服务。
## Q&A
__Q:__ MongoDB无法链接
__A:__ 在`Linux`系统下,无需特定端口映射`-p 2014`,直接使用`--net=host`共享网络模式即可。在`Mac`或`Windows`下,需要在`VT_setting.json`中设置`mongoHost`时,指定其局域网中的`IP`,而非`localhost`。