如何在Vertex AI托管Notebook中程序化启用已安装扩展

一、JupyterLab扩展启用的权限问题 #

在Vertex AI托管Notebook的JupyterLab中，使用启动后bash脚本管理环境时，执行jupyter labextension enable extensionIdentifierHere命令会遇到权限错误：

[Errno 13] Permission denied: '/opt/conda/etc/jupyter/labconfig/page_config.json'
尝试sudo执行需要密码，但未设置过用户密码。

解决方法 #

• 用户级配置替代系统级：无需修改系统目录，添加--user参数让配置写入用户专属目录，命令改为：

  # 查看扩展状态
  jupyter labextension list
  # 用户级启用扩展
  jupyter labextension enable --user extensionIdentifierHere
  

  配置会被写入~/.jupyter/labconfig/page_config.json，无需sudo权限即可执行。
• 设置sudo密码（可选）：若必须修改系统级配置，可通过passwd命令设置当前用户密码，之后就能用sudo执行相关命令。

二、Docker镜像复现环境时ipyleaflet可视化失败问题 #

默认配置的托管Notebook中，通过venv虚拟环境可正常使用geemap和ipyleaflet功能，但Docker镜像中导入模块后无法可视化，报错Error displaying widget: model not found，修改TylerErickson的Dockerfile后仍未解决。

解决方法 #

• 匹配扩展与包版本：确保ipyleaflet与JupyterLab版本兼容，安装时指定对应版本（以兼容组合为例）：

  pip install ipyleaflet==0.17.0 jupyterlab==3.6.0 geemap earthengine-api
  

  注意：JupyterLab 3.x及以上版本，多数widget扩展可直接通过pip安装，无需单独执行jupyter labextension命令。
• 启用核心widget扩展：执行以下命令确保ipywidgets相关扩展正确启用：

  jupyter nbextension enable --py widgetsnbextension --user
  jupyter labextension enable @jupyter-widgets/jupyterlab-manager --user
  jupyter labextension enable jupyter-leaflet --user
  

• 完善Dockerfile构建步骤：在Dockerfile中添加完整依赖安装与扩展启用流程：

  # 安装基础依赖
  RUN pip install --upgrade pip
  # 安装业务相关包
  RUN pip install geemap earthengine-api ipyleaflet jupyterlab widgetsnbextension
  # 用户级启用扩展
  RUN jupyter nbextension enable --py widgetsnbextension --user
  RUN jupyter labextension enable @jupyter-widgets/jupyterlab-manager --user
  RUN jupyter labextension enable jupyter-leaflet --user
  # 设置JupyterLab启动命令
  CMD ["jupyter", "lab", "--ip=0.0.0.0", "--port=8888", "--allow-root", "--no-browser"]
  

• 验证扩展状态：启动容器后，执行jupyter labextension list和jupyter nbextension list，确认jupyter-leaflet、@jupyter-widgets/jupyterlab-manager等扩展已显示为启用状态。

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