Usar SSH para acceder a JupyterLab

Si no tienes acceso HTTPS a tu instancia de JupyterLab, debes usar SSH para establecer una conexión.

Para configurar el reenvío de puertos SSH, sigue estos pasos y, a continuación, accede a tu sesión de JupyterLab a través de un navegador local:

  1. Ejecuta el siguiente comando con la CLI de Google Cloud en el terminal que prefieras o en Cloud Shell:

    gcloud compute ssh \
    --project PROJECT_ID \
    --zone ZONE \
    INSTANCE_NAME \
    -- -L 8080:localhost:8080

    Haz los cambios siguientes:

  1. Accede a tu sesión de JupyterLab a través de un navegador local:

    • Si has ejecutado el comando en tu máquina local, ve a https://localhost:8080 para acceder a JupyterLab.

    • Si has ejecutado el comando con Cloud Shell, accede a JupyterLab a través de la vista previa web en el puerto 8080.

Motivos por los que puede que no tengas acceso HTTPS

Para obtener acceso HTTPS a JupyterLab, tu instancia de cuadernos gestionados por el usuario debe tener acceso a un Google Cloud servicio proxy. Cuando se inicia la instancia, intenta registrarse en el servicio proxy. Si no se puede obtener acceso de proxy, tu instancia de notebook gestionada por el usuario te pedirá que accedas a JupyterLab mediante SSH.

Estos son algunos de los motivos habituales por los que puede que no tengas acceso HTTPS a JupyterLab:

  • La configuración de metadatos del modo proxy de tu instancia de JupyterLab es incorrecta.

  • Tu red está configurada para bloquear el acceso a Internet de las máquinas virtuales que ejecutan cuadernos de JupyterLab.

  • Tu instancia de cuaderno gestionada por el usuario no tiene una dirección IP externa.

  • La configuración de Controles de Servicio de VPC bloquea el acceso a Artifact Registry.

En las siguientes secciones se explica cómo solucionar estos problemas.

Para que los cambios surtan efecto, es posible que tengas que reiniciar la VM del cuaderno al intentar resolver estos problemas.

El ajuste de metadatos del modo proxy de tu instancia de JupyterLab es incorrecto

De forma predeterminada, cuando usas cuadernos gestionados por el usuario para crear una instancia de JupyterLab, Vertex AI Workbench añade el ajuste de metadatos del modo proxy. Si cambias o quitas el ajuste de metadatos del modo proxy, la instancia de notebooks gestionada por el usuario no podrá conectarse al servicio proxy.

Para asegurarte de que el ajuste de metadatos del modo proxy es válido, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página Notebooks gestionados por el usuario.

    Ir a Cuadernos gestionados por usuarios

  2. Selecciona la instancia que quieras modificar.

  3. Junto a Ver detalles de VM, haz clic en Ver en Compute Engine.

  4. En la página de detalles de la VM, haz clic en Editar.

  5. En la sección Metadatos, añade o modifica los metadatos para asegurarte de que haya un proxy-mode entryset to the correct value, for example:project_editors`.

    Consulta más información sobre los posibles valores de la entrada de metadatos proxy-mode.

  6. Haz clic en Guardar.

La red está bloqueando el acceso a Internet

Tu instancia de JupyterLab accede al servicio proxy a través de una URL pública. Si la configuración de tu red de nube privada virtual (VPC) bloquea el acceso a Internet público o tus reglas de cortafuegos bloquean el tráfico saliente, debes usar SSH para acceder a tu instancia de cuaderno gestionada por el usuario. Si es posible, puedes trabajar con los administradores de tu red y tu cortafuegos para permitir el acceso a tu instancia de cuadernos gestionados por el usuario a través de Internet público.

Tu instancia de notebooks gestionados por el usuario no tiene una dirección IP externa

Es posible que hayas creado tu instancia de cuadernos gestionados por usuarios sin una dirección IP externa. Si necesitas cambiarlo, sigue estos pasos.

  1. En la Google Cloud consola, ve a la página Notebooks gestionados por el usuario.

    Ir a Cuadernos gestionados por usuarios

  2. Haga clic en el nombre de la instancia que quiera modificar.

  3. Haz clic en Ver detalles de la VM.

  4. Haz clic en Editar.

  5. En la sección Interfaces de red, despliega la red a la que quieras asignar una dirección IP externa.

  6. Haga clic en el menú desplegable Dirección IP externa y seleccione la opción que quiera. Para solucionar este problema, no debes elegir Ninguno.

  7. En la sección Interfaces de red, haz clic en Hecho.

  8. Haz clic en Guardar.

La configuración de Controles de Servicio de VPC bloquea el acceso a Artifact Registry

Para conectarse al servicio proxy, tu instancia de cuaderno gestionada por el usuario ejecuta un agente que descarga de Artifact Registry. Sin este agente, tu instancia no podrá conectarse al servicio proxy.

Si la configuración de Controles de Servicio de VPC bloquea el acceso a Artifact Registry, debes añadir el servicio Artifact Registry al perímetro de servicio de Controles de Servicio de VPC. Consulta más información sobre cómo funcionan los perímetros de servicio y qué servicios se pueden proteger con Controles de Servicio de VPC.

Más soluciones de problemas

Si sigues teniendo problemas para conectarte, prueba a revisar los registros de la consola de tu máquina virtual. Estos registros pueden ayudarte a descubrir por qué la instancia de notebooks gestionados por el usuario no puede registrarse en el servicio proxy.

Para acceder a estos registros, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página Notebooks gestionados por el usuario.

    Ir a Cuadernos gestionados por usuarios

  2. Selecciona la instancia sobre la que quieres solucionar problemas.

  3. En Registros, haz clic en Puerto serie 1 (consola).

Siguientes pasos

Para obtener consejos sobre cómo resolver otros problemas, consulta la sección de solución de problemas de los cuadernos gestionados por el usuario.