Usar SSH para acceder a JupyterLab

En esta guía se describe cómo acceder a la interfaz de usuario de JupyterLab de tu instancia de Vertex AI Workbench mediante el reenvío de puertos SSH.

Configurar el reenvío de puertos SSH y acceder a la interfaz de usuario de JupyterLab

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:

    Si usas Cloud Shell para ejecutar el comando, añade un -4 a las marcas de SSH para usar IPv4 al conectarte. Por ejemplo:

    -- -4 -L LOCAL_PORT:localhost:REMOTE_PORT

  2. 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.

Por qué puede que necesites acceder a tu instancia mediante SSH

Para obtener acceso HTTPS a JupyterLab, tu instancia de Vertex AI Workbench debe tener acceso a un servicio de proxy de Google Cloud . Cuando se inicia la instancia, intenta registrarse en el servicio proxy. Si no se puede obtener acceso de proxy, la instancia te pedirá que accedas a JupyterLab a través de 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 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 creas una instancia de Vertex AI Workbench, 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 no podrá conectarse al servicio proxy.

Para añadir o modificar los metadatos y asegurarte de que hay una entrada del modo proxy con el valor correcto (por ejemplo, project_editors), usa el método projects.locations.instances.patch de la API Notebooks o el comando gcloud workbench instances update del SDK de Google Cloud.

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 bloquea el acceso a Internet público o tus reglas de cortafuegos bloquean el tráfico de salida, debes usar SSH para acceder a tu instancia de Vertex AI Workbench. Si es posible, puedes colaborar con los administradores de tu red y tu cortafuegos para permitir el acceso a tu instancia a través de Internet público.

Tu instancia no tiene una dirección IP externa

Es posible que hayas creado tu instancia de Vertex AI Workbench sin una dirección IP externa. Si necesitas cambiarlo, sigue estos pasos.

  1. En la consola, ve a la página Instancias. Google Cloud

    Ir a Instancias

  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 Vertex AI Workbench 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 Vertex AI Workbench no puede registrarse en el servicio proxy.

Para acceder a estos registros, sigue estos pasos:

  1. En la consola, ve a la página Instancias. Google Cloud

    Ir a Instancias

  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 las instancias de Vertex AI Workbench.