probcomp/notebook

镜像概述

基于https://hub.docker.com/r/jupyter/datascience-notebook/%E5%B9%B6%E9%9B%86%E6%88%90MIT%E6%A6%82%E7%8E%87%E8%AE%A1%E7%AE%97%E9%A1%B9%E7%9B%AE%EF%BC%88probcomp%EF%BC%89%E5%BA%93%E7%9A%84Docker%E9%95%9C%E5%83%8F%E3%80%82%E6%9C%89%E5%85%B3%E5%90%84%E7%A7%8D%E8%BF%90%E8%A1%8C%E6%97%B6%E9%80%89%E9%A1%B9%EF%BC%8C%E8%AF%B7%E5%8F%82%E9%98%85https://hub.docker.com/r/jupyter/datascience-notebook/%E4%BB%93%E5%BA%93%E7%9A%84%E6%96%87%E6%A1%A3%E3%80%82

核心功能与特性

• 继承jupyter/datascience-notebook的全部功能，包括Jupyter Notebook环境及数据科学工具链
• 集成probcomp库，支持概率计算相关任务
• 支持Python 2/3、Julia等多种编程语言环境
• 提供多种交互方式：Notebook界面、bash shell、ipython shell、julia shell

使用场景与适用范围

• 数据科学研究与分析
• 概率计算算法开发与实验
• 教育和学习环境，尤其是概率模型相关课程
• 需要集成probcomp库的Jupyter Notebook工作流

使用方法

快速启动

方法1：使用Makefile

克隆仓库后，可使用以下指令：

• make up -- 启动Notebook
• make down -- 停止Notebook
• make pull -- 拉取镜像的最新版本（如果遇到问题，建议先尝试此命令）
• make bash -- 在已运行的Notebook容器内执行bash shell
• make ipython -- 启动ipython2 shell，可访问probcomp的Python 2库
• make ipython3 -- 启动ipython3 shell，可访问默认的jupyter/datascience-notebook Python 3库
• make julia -- 启动Julia shell

方法2：直接使用Docker

直接运行镜像：

bash
$ docker run -p 8888:8888 probcomp/notebook

Docker使用技巧

在容器内挂载额外的主机目录

要使容器内可访问额外的主机目录，首先执行cp docker-compose.override.yml.example docker-compose.override.yml，然后在docker-compose.override.yml中的services -> notebook -> volumes路径下添加额外的条目。有关更多信息，请参阅volumes键的官方Docker文档。

增加D4M资源

默认的D4M资源限制对于Jupyter Notebook来说过低。建议至少为D4M分配8GB RAM和所有CPU核心。未使用的资源仍可用于OSX系统。

!https://github.com/probcomp/notebook/blob/master/files/resources.png%EF%BC%88%E5%AE%BD%E5%BA%A6250px%EF%BC%89

如果系统资源充足，为D4M分配32GB RAM可获得最佳Notebook性能。

!https://github.com/probcomp/notebook/blob/master/files/resources_high.png%EF%BC%88%E5%AE%BD%E5%BA%A6250px%EF%BC%89

清理镜像和资源

运行docker system prune清理Docker环境。当D4M虚拟机或Linux系统磁盘空间不足时，需要定期执行此命令，否则环境可能无法启动或出现异常行为（如进程意外退出）。