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 enus-west1-a
cuando se registra con la API de Notebooks. Sin embargo, una instancia heredada de notebooks administrada por el usuario enus-central1-f
no se registrará con la API de Notebooks porqueus-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
En la consola de Google Cloud, ve a la página Instancias de VM.
Busca tu instancia heredada de notebooks administrada por el usuario.
Haz clic en el nombre de la instancia para abrir la página Detalles de instancia de VM.
En las secciones disco de arranque y discos adicionales, verifica cuántos discos están conectados a la VM.
gcloud
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 instanciaMY_ZONE
: es la zona de la instancia.
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:
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_ID
El 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.
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 llamadomy-bucket/legacy-notebooks
.gcloud storage cp /home/jupyter/*.ipynb gs://my-bucket/legacy-notebooks/ --recursive
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 proyectoexample
con la última imagen de TensorFlow 2, con un tipo de máquinan1-standard-1
en la zonaus-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.
Usa
ssh
para conectarte a la instancia de notebooks administrada por el usuario que acabas de crear.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
En la nueva instancia de notebooks administrados por el usuario, abre JupyterLab y confirma que los datos y elementos del usuario se copiaron correctamente.
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:
En la consola de Google Cloud, ve a la página Notebooks administrados por el usuario.
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.
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 instanciaMY_ZONE
: es la zona de la instancia.