uodcvip/rapidsai

JupyterHub DockerSpawner 镜像

镜像概述

该Docker镜像专为运行dockerspawner的JupyterHub服务器设计，作为用户容器镜像使用。构建仓库托管于https://github.com/UoD-CVIP/ServerImageBuilder/%E3%80%82%E5%85%B6%E6%A0%B8%E5%BF%83%E4%BB%B7%E5%80%BC%E5%9C%A8%E4%BA%8E%E7%A1%AE%E4%BF%9D%E4%B8%8E%E7%89%B9%E5%AE%9AJupyterHub%E5%AE%9E%E4%BE%8B%E7%9A%84%E5%85%BC%E5%AE%B9%E6%80%A7%EF%BC%8C%E5%B9%B6%E6%8F%90%E4%BE%9BGPU%E6%94%AF%E6%8C%81%E5%8F%8A%E5%BF%85%E8%A6%81%E6%89%A9%E5%B1%95%E3%80%82

核心功能与特性

• 版本兼容性：严格限制Jupyter包版本以避免兼容性问题，具体要求：

  jupyterhub>=1.1.0<=1.2.0
  jupyterlab>=1.2.1<=1.3.0
  

• 扩展支持：内置jupyter-nvdashboard等扩展，增强Jupyter环境功能。
• GPU支持：可通过nvidia-container-runtime实现在GPU环境中运行。

使用场景

适用于需要通过JupyterHub服务器（配合dockerspawner）生成用户容器的场景，尤其适合对Jupyter版本有严格兼容性要求、需要GPU加速计算及特定扩展支持的教学或科研环境。

使用方法与配置说明

前置要求

• 安装nvidia-container-runtime以支持GPU运行。

JupyterHub配置

需在jupyterhub_config.py中进行如下配置：

1. 额外主机配置

python
c.Spawner.extra_host_config = {
    'runtime': 'nvidia',  # 启用nvidia运行时支持GPU
    'shm_size': '16G',    # 增大共享内存（默认值过小）
}

2. 卷挂载配置

（注：这些挂载配置将在未来版本中移除）

python
c.Spawner.volumes = {
    'tensorboard': '/shares/local/tensorboard',
    'cvip': '/shares/local/cvip',
    '/mnt/share': '/shares/share',
    '/mnt/studentshare': '/shares/studentshare',
}