uodcvip/cpu

JupyterHub Dockerspawner镜像文档

镜像概述

本镜像专为运行dockerspawner的JupyterHub服务器设计，构建仓库位于https://github.com/UoD-CVIP/ServerImageBuilder/%E3%80%82%E5%9F%BA%E4%BA%8Ehttps://github.com/jupyter/docker-stacks/tree/master/datascience-notebook%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%89%A9%E5%B1%95%E4%BA%86c++%E5%86%85%E6%A0%B8%E6%94%AF%E6%8C%81%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E9%9C%80%E8%A6%81%E7%89%B9%E5%AE%9AJupyter%E7%8E%AF%E5%A2%83%E9%85%8D%E7%BD%AE%E7%9A%84JupyterHub%E5%AE%9E%E4%BE%8B%E3%80%82

核心功能与特性

• 基础镜像：基于Jupyter datascience-notebook，包含数据科学相关的常用库和工具
• 额外内核：添加c++内核，支持C++语言的Jupyter笔记本开发
• 版本控制：严格限制Jupyter相关包版本以确保与JupyterHub实例兼容性：
  • jupyterhub>=1.1.0<=1.2.0
  • jupyterlab>=1.2.1<=1.3.0
• 扩展组件：包含jupyter-nvdashboard等扩展，增强Jupyter环境功能

使用场景

适用于需要通过dockerspawner管理容器的JupyterHub部署环境，特别适合需要C++内核支持、特定Jupyter版本控制以及nvdashboard监控功能的学术或研究机构使用。

使用方法与配置说明

版本要求

使用本镜像时，需确保JupyterHub实例环境满足以下包版本要求：

• JupyterHub：1.1.0至1.2.0版本之间
• JupyterLab：1.2.1至1.3.0版本之间

挂载目录配置

当前版本需要挂载以下目录（未来版本将移除此要求）：

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

部署示例

在JupyterHub配置中使用本镜像时，需在jupyterhub_config.py中进行如下配置：

python
c.JupyterHub.spawner_class = 'dockerspawner.DockerSpawner'
c.DockerSpawner.image = 'your-image-name:tag'  # 替换为实际镜像名称和标签

# 挂载目录配置
c.Spawner.volumes = {
    'tensorboard': '/shares/local/tensorboard',
    'cvip': '/shares/local/cvip',
    '/mnt/share': '/shares/share',
    '/mnt/studentshare': '/shares/studentshare',
}

注意事项

• 挂载目录要求将在未来版本中移除，建议关注构建仓库的更新说明
• 确保JupyterHub实例版本与镜像要求的Jupyter包版本兼容，避免出现环境冲突
• 如需添加额外扩展或依赖，可基于本镜像进行二次构建