Usa SSH para acceder a JupyterLab

Cuando no tengas acceso HTTPS a tu instancia de JupyterLab, debes usar SSH para establecer una conexión a fin de acceder a JupyterLab.

Sigue estos pasos para configurar la redirección de puertos SSH y, luego, accede a tu sesión de JupyterLab a través de un navegador local:

  1. Escribe el siguiente comando en Cloud Shell o en un entorno local en el que está instalado el SDK de Cloud. Reemplaza my-project-id, my-zone y my-instance por la información relevante.

    export PROJECT_ID="my-project-id"
    export ZONE="my-zone"
    export INSTANCE_NAME="my-instance"
    gcloud compute ssh --project $PROJECT_ID --zone $ZONE \
      $INSTANCE_NAME -- -L 8080:localhost:8080
    
  2. Si ejecutaste el comando en tu máquina local, visita https://localhost:8080 para acceder a JupyterLab.

    Si usas Cloud Shell, accede a JupyterLab a través de la vista previa web en el puerto 8080. El botón de vista previa web Botón Vista previa en la Web se puede encontrar en la parte superior derecha de la barra de tareas de Cloud Shell.

Motivos por los que podrías no tener acceso HTTPS

Para obtener acceso HTTPS a JupyterLab, la instancia de AI Platform Notebooks 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 consigue acceso al proxy, AI Platform Notebooks solicita que accedas a JupyterLab mediante SSH.

Estos son algunos motivos comunes por los 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 que ejecutan notebooks de JupyterLab.

  • Tu instancia de AI Platform Notebooks no tiene una dirección IP externa.

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

Encontrarás más información sobre cómo resolver estos problemas en las siguientes secciones.

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

De forma predeterminada, cuando utilizas AI Platform Notebooks para crear una instancia de JupyterLab, la configuración de metadatos de modo proxy se agrega automáticamente, pero si cambias o quitas esa configuración, el notebook ya no podrá 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. Ve a la página AI Platform Notebooks en Google Cloud Console.

    Ir a la página AI Platform Notebooks

  2. En la columna Nombre de instancia, haz clic en la instancia de AI Platform Notebooks que necesitas modificar.

  3. Haz clic en Editar.

  4. Desplázate hacia abajo hasta la sección Custom metadata (Metadatos personalizados), y agrega o modifica los metadatos para asegurarte de que haya una entrada de modo proxy establecida en project_editors.

    Configuración de metadatos con modo proxy definido como project_editors

  5. 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 AI Platform Notebooks. 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 AI Platform Notebooks a través de la Internet pública.

Tu instancia de AI Platform Notebooks no tiene una dirección IP externa

Es posible que hayas creado tu instancia de AI Platform Notebooks sin una dirección IP externa. Si necesitas cambiar esto, completa los siguientes pasos.

  1. Ve a la página AI Platform Notebooks en Google Cloud Console.

    Ir a la página AI Platform Notebooks

  2. En la columna Nombre de instancia, haz clic en la instancia de AI Platform Notebooks que necesitas modificar.

  3. Haz clic en Editar.

  4. Desplázate hasta la sección Interfaces de red y, en Interfaces de red, haz clic en el cuadro para que se expanda.

  5. En External IP (IP externa), haz clic en el menú desplegable, selecciona la opción que desees y ajusta el resto de la configuración de la dirección IP según tus necesidades. Ten en cuenta que, para que se resuelva el problema, no debes elegir la opción Ninguna.

    Configuración de la interfaz de red

  6. En la parte inferior del cuadro Interfaces de red, haz clic en Listo (Done).

  7. Haz clic en Guardar.

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

Para conectarte al servicio de proxy, tu instancia de AI Platform Notebooks ejecuta un agente que descarga desde Container Registry. Sin este agente, tu instancia no puede conectarse al servicio de proxy.

Si tu configuración de los Controles del servicio de VPC bloquea el acceso a Container Registry, debes agregar el servicio de Container 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é el notebook no puede registrarse con el servicio de proxy.

Para acceder a estos registros, completa los siguientes pasos:

  1. Ve a la página AI Platform Notebooks en Google Cloud Console.

    Ir a la página AI Platform Notebooks

  2. Haz clic en el nombre de la instancia de AI Platform Notebooks en la que deseas solucionar problemas.

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

Pasos siguientes

Consulta Solución de problemas de notebooks para obtener sugerencias sobre cómo resolver otros problemas.