Abrir JupyterLab
El botón Abrir
Despliegue una plantilla cuyo modo de lanzamiento sea jupyter, espere a que la instancia llegue a running y luego ábrala desde Instancias. En la pestaña Conectar hay un botón Abrir JupyterLab. Lo lleva directamente a una sesión autenticada en una pestaña nueva.
El botón es la vía de acceso admitida. No intente armar la dirección por su cuenta y no dependa de un marcador: el host y el puerto en los que se publica una instancia pueden cambiar después de detenerla e iniciarla, y entonces el marcador no apunta a nada.
Si falta el botón, revise el modo de lanzamiento de la plantilla que desplegó. Solo jupyter inicia un servidor de notebooks. Una instancia en modo ssh le da un shell, no un notebook. Consulte Modos de lanzamiento.
Sobre el token
El token de acceso lo genera la plataforma cuando se despliega la instancia y se pasa al contenedor, que inicia JupyterLab con ese token como única credencial. Usted nunca lo elige y nunca se devuelve como campo propio en ninguna respuesta de la API.
De ahí se desprenden dos cosas:
- Abra JupyterLab desde la consola. El botón lleva el token por usted, así que no tiene que armar la dirección.
- Definir
JUPYTER_TOKENpor su cuenta en el entorno no hace nada. La capa de entorno de la plataforma siempre prevalece sobre los valores proporcionados por el arrendatario, por lo que su entrada se sobrescribe. Lo mismo aplica aGPU_COUNT. Consulte Variables de entorno.
Dónde están sus archivos
JupyterLab tiene su raíz en JUPYTER_DIR, que por omisión es /workspace. El explorador de archivos no puede navegar por encima de ese directorio, así que todo lo que quiera ver en la barra lateral debe estar dentro de él.
| Ajuste | Valor por omisión | De dónde viene |
|---|---|---|
JUPYTER_DIR | /workspace | el campo jupyter_dir de la plantilla |
JUPYTER_PORT | 8080 | el puerto del contenedor que publica el modo jupyter |
JUPYTER_LAB | true (Lab) | el campo use_jupyter_lab de la plantilla; false sirve el notebook clásico |
/workspace está en el disco que dimensionó al desplegar, así que sobrevive a una detención y un inicio, y se elimina al destruir. Los archivos escritos en otras partes del contenedor están en el mismo disco y corren la misma suerte: el directorio es una convención, no un volumen aparte.
La pestaña se abrió antes de que el servidor estuviera listo
El botón Abrir JupyterLab aparece en cuanto la instancia informa running. El servidor de notebooks enlaza su puerto un momento después, así que un clic prematuro puede terminar en un error del navegador: una conexión rechazada o una página que nunca termina de cargar.
Espere unos segundos y recargue la pestaña. La imagen base inicia JupyterLab antes de ejecutar el script onstart de la plantilla, así que un onstart largo no es lo que está reteniendo al servidor de notebooks. Si al recargar sigue fallando, lea el log propio del servidor por SSH:
tail -f /var/log/superheat/jupyter.log
La advertencia del certificado
JupyterLab se sirve por HTTPS con un certificado que el contenedor genera para sí mismo, así que su navegador advierte que no puede verificar el sitio. Esa advertencia es esperable en una instancia recién creada. El cifrado está haciendo su trabajo; solo la identidad no se puede verificar, porque ninguna autoridad pública ha firmado un certificado para una máquina que existe desde hace minutos.