mathhub/jupyter

JupyterHub-Deployment

JupyterHub-Deployment 提供了 https://github.com/kwarc/jupyter-console-standalone%E3%80%81https://github.com/UniFormal/mmt_jupyter_kernel 和 https://github.com/MathHubInfo/MoSIS_Jupyter_Kernel 的参考部署，基于 Docker 实现。

免责声明

此部署不适用于生产环境。它是一个参考实现，在可用性和可扩展性方面不符合传统要求。

技术概述

此参考部署的关键组件包括：

• 主机：在主机的Docker容器中运行 JupyterHub组件 和 https://uniformal.github.io/ 服务器。

• 认证器：使用 https://github.com/jupyterhub/tmpauthenticator 动态创建用户账户。

• 生成器：使用 https://github.com/jupyter/dockerspawner 在同一主机的独立Docker容器中生成单用户Jupyter Notebook服务器。

• Hub数据持久化：将JupyterHub数据持久化到主机上的Docker卷中。

• 用户笔记本目录持久化：将用户笔记本目录持久化到主机上的Docker卷中。

前提条件

Docker

此部署通过 Docker Compose 使用Docker。需要 Docker Engine 1.12.0或更高版本。

1. 按照 Docker安装说明 为您的环境设置Docker。

2. 要验证Docker安装（无论是本地安装还是使用 docker-machine），输入以下命令：

   bash
   docker version
   docker ps
   

配置设置

运行配置脚本：

bash
./configure

在此处可以选择域名，并指定应安装到MMT的额外归档。

运行JupyterHub

在主机上运行JupyterHub容器。

要以分离模式运行JupyterHub容器：

bash
docker-compose up -d

容器运行后，可通过以下地址访问JupyterHub控制台：

https://mydomain

要停止JupyterHub容器：

bash
docker-compose down