Usa SSH para acceder a JupyterLab

Siempre que no tengas acceso HTTPS a tu instancia de JupyterLab, debes establecer una conexión mediante SSH.

Para configurar la redirección de puertos SSH, completa los siguientes pasos y, luego, accede a tu sesión de JupyterLab a través de un navegador local:

  1. Ejecuta el siguiente comando mediante la CLI de Google Cloud en tu terminal preferida o en Cloud Shell:

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

    Reemplaza lo siguiente:

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

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

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

Motivos por los que podrías no tener acceso HTTPS

Para obtener acceso HTTPS a JupyterLab, la instancia de Vertex AI Workbench debe tener acceso a un servicio de proxy de Google Cloud. La instancia intenta registrarse con el servicio de proxy cuando se inicia. Si no se puede obtener acceso al proxy, la instancia te solicita que accedas a JupyterLab mediante SSH.

Las siguientes son razones comunes por las que podrías no tener acceso HTTPS a JupyterLab:

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

  • Tu red está configurada para bloquear el acceso a Internet en las máquinas virtuales (VM) que ejecutan notebooks de JupyterLab.

  • Tu instancia no tiene una dirección IP externa.

  • La configuración de los Controles del servicio de VPC bloquea el acceso a Artifact Registry.

En las siguientes secciones, se muestra cómo resolver estos problemas.

Para que se apliquen los cambios, es posible que debas reiniciar la VM del notebook cuando intentes resolver estos problemas.

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

De forma predeterminada, cuando creas una instancia de Vertex AI Workbench, Vertex AI agrega el parámetro de configuración de metadatos del modo proxy. Si cambias o quitas la configuración de metadatos de modo proxy, la instancia no puede conectarse al servicio de proxy.

Para asegurarte de que la configuración de metadatos de modo proxy sea válida, completa los siguientes pasos:

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

    Ir a Instancias

  2. Selecciona la instancia que necesitas modificar.

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

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

  5. En la sección Metadatos, agrega o modifica los metadatos para asegurarte de que haya una entrada de modo proxy establecida con el valor correcto, por ejemplo: project_editors.

  6. Haz clic en Guardar.

La red bloquea el acceso a Internet

La instancia de JupyterLab accede al servicio de proxy a través de una URL pública. Si la configuración de red de la nube privada virtual bloquea el acceso a la Internet pública o si las reglas de firewall bloquean el tráfico de salida, debes usar SSH para acceder a la instancia de Vertex AI Workbench. Si es posible, tal vez sea conveniente que trabajes con los administradores de la red y el firewall para permitir el acceso a la instancia a través de la Internet pública.

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 cambiar esto, completa los siguientes pasos.

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

    Ir a Instancias

  2. Haz clic en el nombre de la instancia que deseas modificar.

  3. Haz clic en Ver detalles de la VM.

  4. Haz clic en Editar.

  5. En la sección Interfaces de red, expande la red en la que deseas tener una dirección IP externa.

  6. Haz clic en el menú desplegable Dirección IP externa y selecciona la opción que desees. Para resolver este problema, no debes elegir Ninguna.

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

  8. Haz clic en Guardar.

La configuración de los Controles del servicio de VPC bloquea el acceso a Artifact Registry

Para conectarte al servicio de proxy, tu instancia de Vertex AI Workbench ejecuta un agente que descarga desde Artifact Registry. Sin este agente, la instancia no puede conectarse al servicio de proxy.

Si tu configuración de los Controles del servicio de VPC bloquea el acceso a Artifact Registry, debes agregar el servicio de Artifact Registry al perímetro de servicio de tus Controles del servicio de VPC. Obtén más información sobre cómo funcionan los perímetros de servicio y qué servicios se pueden proteger con Controles del servicio de VPC.

Solución de otros problemas

Si aún tienes problemas para conectarte, intenta revisar los registros de tu máquina virtual en Console. Estos registros pueden ayudarte a descubrir por qué la instancia de Vertex AI Workbench no puede registrarse con el servicio de proxy.

Para acceder a estos registros, completa los siguientes pasos:

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

    Ir a Instancias

  2. Selecciona la instancia en la que deseas solucionar problemas.

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

¿Qué sigue?

Para obtener sugerencias para saber resolver otros problemas, consulta la sección de solución de problemas en instancias de Vertex AI Workbench.