uodcvip/matlab

MATLAB Docker镜像文档

镜像概述

本镜像基于NVIDIA NGC容器 registry的镜像构建，专为使用JupyterHub和dockerspawner的本地GPU服务器设计。镜像包含MATLAB JupyterHub内核等必要修改，构建仓库位于https://github.com/UoD-CVIP/ServerImageBuilder/。

核心功能和特性

• Jupyter包版本控制：为确保与JupyterHub实例兼容，限制以下版本范围：

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

• 扩展组件：包含jupyter-nvdashboard等扩展工具

使用场景

适用于需要在JupyterHub环境中运行MATLAB的本地GPU服务器，特别适合需要GPU加速的科学计算、数据处理和机器学习任务。

使用方法和配置说明

前提条件

• 安装nvidia-container-runtime
• 具备有效的MATLAB许可证（非邓迪大学用户需自行配置）

JupyterHub配置

需在jupyterhub_config.py中添加以下配置：

python
# 配置GPU运行时和共享内存
c.Spawner.extra_host_config = {
    'runtime': 'nvidia',
    'shm_size': '16G',  # 默认值过小，需显式设置
}

# 挂载必要目录（未来版本将移除）
c.Spawner.volumes = {
    'tensorboard': '/shares/local/tensorboard',
    'cvip': '/shares/local/cvip',
    '/mnt/share': '/shares/share',
    '/mnt/studentshare': '/shares/studentshare',
}

MATLAB许可证配置

重要：非邓迪大学用户必须安装有效的MATLAB许可证，否则将无法访问网络许可证文件，执行matlab命令时会出现以下错误：

root@172aa961b472:~# matlab
MATLAB is selecting SOFTWARE OPENGL rendering.
License checkout failed.
License Manager Error -15
Unable to connect to the license server. 
Check that the network license manager has been started, and that the client machine can communicate
with the license server.
# ...
# 其他诊断输出

许可证配置方法

1. 挂载许可证文件：

   bash
   docker run -it --gpus all -v /path/to/your/license.data:/opt/matlab/R2020b/licenses/license.dat:ro docker.xuanyuan.run/uodcvip/matlab:r2020b matlab
   

2. 设置网络许可证环境变量：

   bash
   docker run --gpus all -it -e MLM_LICENSE_FILE=<your-connection-details> docker.xuanyuan.run/uodcvip/matlab:r2020b matlab