Usa SSH para acceder a JupyterLab

Usa SSH para acceder a JupyterLab

Los notebooks administrados por el usuario de Vertex AI Workbench están obsoletos. El 30 de enero de 2025, finalizará la compatibilidad con notebooks administrados por el usuario y se quitará la capacidad de crear instancias de notebooks administrados por el usuario. Las instancias existentes seguirán funcionando, pero los parches y las actualizaciones no estarán disponibles. Para seguir usando Vertex AI Workbench, te recomendamos migrar tus instancias de notebooks administrados por el usuario a instancias de Vertex AI Workbench.

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 \
       --project PROJECT_ID \
       --zone ZONE \
       INSTANCE_NAME \
       -- -L 8080:localhost:8080

   Reemplaza lo siguiente:

   • PROJECT_ID: el ID del proyecto de Google Cloud
   • ZONE: es la zona en la que se encuentra la instancia.
   • INSTANCE_NAME: nombre de tu instancia

Nota: Si usas Cloud Shell a fin de ejecutar el comando, agrega un -4 a las marcas SSH para usar IPv4 a fin de conectarte. Ejemplo: -- -4 -L LOCAL_PORT:localhost:REMOTE_PORT

1. 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 notebooks administrada por el usuario 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 de notebooks administrada por el usuario te solicita acceder 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 de notebooks administrada por el usuario 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 usas notebooks administrados por el usuario para crear una instancia de JupyterLab, Vertex AI Workbench agrega la configuración de metadatos de modo proxy. Si cambias o quitas la configuración de metadatos de modo proxy, la instancia de notebooks administrada por el usuario 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 Notebooks administrados por el usuario.

   Ir a Notebooks administrados por el usuario

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 un proxy-mode entryset to the correct value, for example:project_editors`.

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

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 notebook administrada por el usuario. 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 de notebook administrada por el usuario a través de la Internet pública.

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

Es posible que hayas creado tu instancia de notebooks administrada por el usuario 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 Notebooks administrados por el usuario.

   Ir a Notebooks administrados por el usuario

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 notebook administrada por el usuario 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 notebooks administrada por el usuario 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 Notebooks administrados por el usuario.

   Ir a Notebooks administrados por el usuario

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 sobre cómo resolver otros problemas, consulta la sección de solución de problemas en notebooks administrados por el usuario.