Registra una instancia heredada con la API de Notebooks

En esta página, se muestra cómo migrar y registrar una instancia heredada de notebooks administrada por el usuario con la API de Notebooks. Las instancias creadas con la API de Compute Engine se denominan instancias heredadas. Las instancias heredadas no tienen las actualizaciones más recientes de la funcionalidad y las características.

Para usar la funcionalidad y las funciones nuevas disponibles con la API de Notebooks, debes registrar tus instancias heredadas con esta API. Antes de registrar tus instancias heredadas, verifica si cumplen con los requisitos. Puedes migrar instancias que no cumplan con los requisitos.

Si habilitas la API de Notebooks antes de registrar tus instancias heredadas, el proceso de activación de la API de Notebooks intenta registrar tus instancias heredadas existentes de forma automática.

Requisitos y limitaciones

Antes de registrar tus instancias heredadas con la API de Notebooks, ten en cuenta los siguientes requisitos y limitaciones.

  • Las zonas de origen y de destino deben coincidir y ser una zona válida para la API de Notebooks.

    Por ejemplo, una instancia heredada de notebooks administrada por el usuario en us-west1-a permanece en us-west1-a cuando se registra con la API de Notebooks. Sin embargo, una instancia heredada de notebooks administrada por el usuario en us-central1-f no se registrará con la API de Notebooks porque us-central1-f no es una zona válida para esta API.

    A fin de obtener una lista de las zonas válidas para las instancias de notebooks de la API de Notebooks, ejecuta el siguiente comando mediante Google Cloud CLI en tu terminal preferida o en Cloud Shell:

    gcloud notebooks locations list

    Si la zona de tu instancia heredada no es válida para la API de Notebooks, comunícate con el equipo de asistencia o tu administrador de cuentas, o migra la instancia heredada a una nueva instancia de notebooks administrada por el usuario.

  • Solo las instancias de disco doble pueden usar todas las funciones de los notebooks administrados por el usuario.

    Las instancias heredadas de un solo disco no pueden usar algunas funciones de los notebooks administrados por el usuario, como la actualización automática, incluso después de que se registren con la API de Notebooks. Para habilitar la instancia heredada de un solo disco a fin de usar todas las funciones disponibles, debes migrar la instancia de un solo disco a una de doble disco.

    Puedes migrar tu instancia de un solo disco a una de doble disco como parte de la migración de una instancia heredada a una instancia registrada con la API de Notebooks. Si ya registraste la instancia heredada con la API de Notebooks, aún puedes migrar la instancia a una instancia nueva de doble disco para resolver el problema.

    Para verificar la cantidad de discos, completa los siguientes pasos.

    Console

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

      Ir a Instancias de VM

    2. Busca tu instancia heredada de notebooks administrada por el usuario.

    3. Haz clic en el nombre de la instancia para abrir la página Detalles de instancia de VM.

    4. En las secciones disco de arranque y discos adicionales, verifica cuántos discos están conectados a la VM.

    gcloud

    1. En Cloud Shell o cualquier entorno en el que esté instalada Google Cloud CLI, ingresa el siguiente comando de Google Cloud CLI:

      gcloud compute instances describe MY_INSTANCE_NAME \
          --zone=MY_ZONE

      Reemplaza lo siguiente:

      • MY_INSTANCE_NAME: el nombre de tu instancia
      • MY_ZONE: es la zona de la instancia.
    2. Revisa la información que sigue a discos: y verifica cuántos discos están conectados a la VM.

Migra una instancia heredada a una instancia nueva de notebooks administrada por el usuario

Si tu instancia heredada de notebooks administrada por el usuario está en una zona que no es válida para la API de Notebooks o si deseas migrar de una instancia de un solo disco a una de doble disco, debes crear una instancia de notebook administrada por el usuario y copiar los datos del usuario de la instancia heredada a la nueva.

Para crear una instancia de notebooks administrada por el usuario y copiar los datos del usuario de la instancia heredada a la nueva, completa los siguientes pasos:

  1. Si quieres usar ssh para conectarte a tu instancia heredada, en Cloud Shell o cualquier entorno en el que esté instalada Google Cloud CLI, Ingresa el siguiente comando de Google Cloud CLI:

    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

    Reemplaza lo siguiente:

    • MY_PROJECT_IDEl ID de tu proyecto de Google Cloud.
    • MY_ZONE: es la zona de la instancia.
    • MY_INSTANCE: es el nombre de tu instancia con la información relevante.
  2. Para copiar el contenido de la instancia heredada en un bucket de Cloud Storage, usa gcloud storage. El siguiente comando de ejemplo copia todos los archivos del notebook (.ipynb) del directorio predeterminado /home/jupyter/ en un directorio de Cloud Storage llamado my-bucket/legacy-notebooks.

    gcloud storage cp /home/jupyter/*.ipynb gs://my-bucket/legacy-notebooks/ --recursive
  3. Crea una instancia de notebook administrada por el usuario con las mismas especificaciones de hardware que la instancia heredada. Puedes crear la instancia mediante la consola de Google Cloud o Google Cloud CLI.

    En este ejemplo, Vertex AI Workbench crea una instancia de notebooks administrada por el usuario con el nombre new-notebook en el proyecto example con la última imagen de TensorFlow 2, con un tipo de máquina n1-standard-1 en la zona us-west1-a.

    Ya sea en Cloud Shell o en cualquier entorno en el que esté instalada Google Cloud CLI, ingresa el siguiente comando de Google Cloud CLI:

    gcloud notebooks instances create new-notebook \
        --vm-image-project=example \
        --vm-image-family=tf-latest-cpu \
        --machine-type=n1-standard-1 \
        --location=us-west1-a

    La instancia de notebooks administrada por el usuario nueva es de doble disco. Tiene un disco de arranque y uno de datos.

  4. Usa ssh para conectarte a la instancia de notebooks administrada por el usuario que acabas de crear.

  5. Para copiar el contenido de la instancia heredada del bucket de Cloud Storage a la instancia nueva, usa gcloud storage. El siguiente comando de ejemplo copia todos los archivos del notebook (.ipynb) del directorio de Cloud Storage al directorio /home/jupyter/ de la instancia nueva.

    gcloud storage cp gs://my-bucket/legacy-notebooks/*.ipynb  /home/jupyter/ --recursive
  6. En la nueva instancia de notebooks administrados por el usuario, abre JupyterLab y confirma que los datos y elementos del usuario se copiaron correctamente.

  7. Borra la instancia heredada (opcional).

Registra una instancia heredada con la API de Notebooks

Si quieres usar la API de Notebooks para administrar tus instancias heredadas, debes registrarlas con la API de Notebooks.

Si habilitas la API de Notebooks antes de registrar tus instancias heredadas, el proceso de activación de la API de Notebooks intentará registrar automáticamente tus instancias heredadas existentes. Si creas instancias heredadas después de que se habilita la API de Notebooks, debes registrarlas de forma manual mediante uno de los siguientes métodos.

Para registrar tu instancia heredada con la API de Notebooks, puedes usar la consola de Google Cloud o la API de Notebooks.

Console

Para usar la opción Registrar todo en la consola de Google Cloud, sigue estos 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. Si tienes una o más instancias de notebooks administrados por el usuario heredados, aparecerá un mensaje que indica que debes registrarlos con la API de Notebooks. Junto a este mensaje, haz clic en Registrar todo.

  3. Si no tienes ninguna instancia heredada de notebooks administrada por el usuario, pero aún no habilitaste la API de Notebooks, haz clic en Habilitar API de Notebooks para garantizar que las instancias nuevas de notebooks administradas por el usuario se creen con la API de Notebooks.

API de Notebooks

Para usar el método register que proporciona la API de Notebooks, en Cloud Shell o en cualquier entorno en el que esté instalada Google Cloud CLI, ingresa el siguiente comando de Google Cloud CLI:

gcloud notebooks instances register MY_INSTANCE_NAME \
    --location=MY_ZONE

Reemplaza lo siguiente:

  • MY_INSTANCE_NAME: el nombre de tu instancia
  • MY_ZONE: es la zona de la instancia.

¿Qué sigue?