Jupyter在Vertex AI双磁盘环境下kernelspec路径配置问题咨询

1. 为何JUPYTER_PATH/JUPYTER_DATA_DIR未生效？ #

• 路径结构不符合要求：Jupyter不会直接搜索JUPYTER_PATH或JUPYTER_DATA_DIR的根目录，要求路径下必须存在kernels子目录，内核规范文件（如kernel.json）需放在[指定路径]/kernels/[内核名称]/目录下才会被识别。如果你的/home/jupyter/envs下直接存放kernel.json，Jupyter会忽略该文件。
• 环境变量未传递至Jupyter服务进程：终端交互式执行export仅对当前终端进程生效，但Vertex AI的Jupyter是以系统服务形式启动的，服务进程无法读取终端临时设置的环境变量。必须通过系统级配置（如/etc/profile.d/下的脚本）或VM启动脚本在服务启动前设置变量，才能让Jupyter进程获取到。
• 权限与缓存限制：数据盘上的kernels目录及文件需确保Jupyter运行用户（通常为jupyter）拥有读权限；此外Jupyter会缓存已发现的内核列表，修改路径后需重启Jupyter服务才能刷新搜索结果。

2. Jupyter安装在临时盘时的持久化最优策略 #

方案一：通过Jupyter配置指定内核搜索路径 #

• 在数据盘创建Jupyter配置文件（如/home/jupyter/envs/jupyter_notebook_config.py），添加以下配置：

  c.KernelSpecManager.kernel_spec_dirs = ['/home/jupyter/envs/kernels']
  

• 在VM启动脚本中，将该配置文件软链接到临时盘的Jupyter配置目录（通常为/usr/local/etc/jupyter/或~jupyter/.jupyter/），或启动Jupyter时通过--config参数直接指定该文件路径。

方案二：启动时同步kernelspec到临时盘默认路径 #

• 在数据盘维护持久化的kernelspec目录（如/home/jupyter/envs/kernels），包含所有需要暴露的内核配置文件。
• 在VM启动脚本中，执行同步命令将数据盘的kernels目录复制或软链接到临时盘的Jupyter默认kernels路径，示例如下：

  # 确保目标目录存在
  mkdir -p /usr/local/share/jupyter/kernels
  # 软链接方式（更高效）
  ln -s /home/jupyter/envs/kernels/* /usr/local/share/jupyter/kernels/
  

方案三：系统级设置JUPYTER_PATH环境变量 #

• 在数据盘创建环境变量配置脚本（如/home/jupyter/envs/jupyter_path.sh），内容为：

  export JUPYTER_PATH=/home/jupyter/envs
  

• 在VM启动脚本中，将该脚本复制到/etc/profile.d/目录（系统级环境变量加载路径），确保Jupyter服务启动时能读取到该变量。同时需保证/home/jupyter/envs下存在kernels子目录，且内部结构符合Jupyter的kernelspec要求。

内容的提问来源于stack exchange，提问作者user6135514