构建 Docker 镜像

Dockerfile

项目根目录下包含一个 Dockerfile 文件，可用于构建 Docker 镜像。Dockerfile 中提供了两种构建方式可供选择。执行构建命令时，可通过 --build-arg 参数控制镜像版本。--build-arg 参数默认值为 yes，表示构建 qlib 镜像的 stable 版本。

1. 对于 stable 版本，使用 pip install pyqlib 构建 qlib 镜像。

docker build --build-arg IS_STABLE=yes -t <image name> -f ./Dockerfile .

docker build -t <image name> -f ./Dockerfile .

  1. 对于 nightly 版本，使用当前源码构建 qlib 镜像。

docker build --build-arg IS_STABLE=no -t <image name> -f ./Dockerfile .

qlib 镜像的自动构建

  1. 项目根目录下有一个 build_docker_image.sh 文件，可用于自动构建 Docker 镜像并上传至您的 Docker Hub 仓库（可选，需预先配置）。

sh build_docker_image.sh
>>> Do you want to build the nightly version of the qlib image? (default is stable) (yes/no):
>>> Is it uploaded to docker hub? (default is no) (yes/no):

  1. 如果您希望将构建好的镜像上传到您的 Docker Hub 仓库，需要先编辑 build_docker_image.sh 文件，在其中填写 docker_user，然后执行该脚本。

如何使用 qlib 镜像

  1. 启动一个新的 Docker 容器

docker run -it --name <container name> -v <Mounted local directory>:/app <image name>

  1. 此时您已进入 Docker 环境，可以运行 qlib 脚本。示例如下：

>>> python scripts/get_data.py qlib_data --name qlib_data_simple --target_dir ~/.qlib/qlib_data/cn_data --interval 1d --region cn
>>> python qlib/workflow/cli.py examples/benchmarks/LightGBM/workflow_config_lightgbm_Alpha158.yaml

  1. 退出容器

>>> exit

  1. 重启容器

docker start -i -a <container name>

  1. 停止容器

docker stop -i -a <container name>

  1. 删除容器

docker rm <container name>

  1. 有关 Docker 使用的更多信息，请参阅 Docker 文档。