Esta página se ha traducido con Cloud Translation API.

Registrar una instancia antigua con la API de Notebooks

En esta página se muestra cómo migrar y registrar una instancia de cuadernos gestionados por el usuario antigua con la API Notebooks. Las instancias creadas mediante la API Compute Engine se denominan instancias antiguas. Las instancias antiguas no tienen las últimas actualizaciones de funciones.

Para usar las nuevas funciones y características que ofrece la API Notebooks, debes registrar tus instancias antiguas con la API Notebooks. Antes de registrar tus instancias antiguas, comprueba si cumplen los requisitos. Puede migrate las instancias que no cumplan los requisitos.

Si habilitas la API Notebooks antes de registrar tus instancias antiguas, el proceso de activación de la API Notebooks intentará registrar automáticamente tus instancias antiguas.

Requisitos y limitaciones

Antes de registrar tus instancias antiguas 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 Notebooks.

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

Para obtener una lista de las zonas válidas para las instancias de cuadernos de la API Notebooks, ejecuta el siguiente comando con la CLI de Google Cloud en el terminal que prefieras o en Cloud Shell:
```
gcloud notebooks locations list
```
Si la zona de tu instancia antigua no es válida para la API Notebooks, puedes ponerte en contacto con el equipo de Asistencia o con tu gestor de cuentas, o bien migrar la instancia antigua a una instancia de notebooks gestionados por el usuario nueva.
Solo las instancias de doble disco pueden usar todas las funciones de los cuadernos gestionados por el usuario.

Las instancias antiguas de un solo disco no pueden usar algunas funciones de los cuadernos gestionados por el usuario, como la actualización automática, aunque se hayan registrado con la API Notebooks. Para que tu instancia antigua de un solo disco pueda usar todas las funciones disponibles, debes migrar tu instancia de un solo disco a una instancia de dos discos.

Puedes migrar tu instancia de un solo disco a una de dos discos como parte de la migración de una instancia antigua a una registrada con la API Notebooks. Si ya has registrado la instancia antigua con la API Notebooks, puedes migrarla a una nueva instancia de doble disco para solucionar el problema.

Para verificar el número de discos, sigue estos pasos:
Consola
1. En la consola de Google Cloud , ve a la página Instancias de VM.
  
  Ir a instancias de VM
2. Busca tu instancia de cuadernos gestionados por usuarios antigua.
3. Haz clic en el nombre de la instancia para abrir la página Detalles de la instancia de VM.
4. En las secciones Disco de arranque y Discos adicionales, comprueba cuántos discos hay conectados a la VM.
gcloud
1. En Cloud Shell o en cualquier entorno en el que esté instalada Google Cloud CLI, introduce el siguiente comando de Google Cloud CLI:
  gcloud compute instances describe MY_INSTANCE_NAME \ --zone=MY_ZONE
  Haz los cambios siguientes:
  - MY_INSTANCE_NAME: el nombre de tu instancia
  - MY_ZONE: la zona de tu instancia
2. Revisa la información que aparece en discos: y comprueba cuántos discos están conectados a la VM.

Migrar una instancia antigua a una nueva instancia de cuadernos gestionados por usuarios

Si tu instancia de notebooks gestionados por el usuario antigua está en una zona que no es válida para la API Notebooks o si quieres migrar de una instancia de un solo disco a una de dos discos, debes crear una instancia de notebooks gestionados por el usuario y copiar tus datos de usuario de la instancia antigua a la nueva.

Para crear una instancia de cuadernos gestionados por usuarios y copiar tus datos de usuario de tu instancia antigua a la nueva, sigue estos pasos:

Para usar ssh y conectarte a tu instancia antigua, en Cloud Shell o en cualquier entorno en el que esté instalada la CLI de Google Cloud, introduce el siguiente comando de la CLI de Google Cloud:
```
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
```
Haz los cambios siguientes:
- MY_PROJECT_ID: el ID de tu Google Cloud proyecto
- MY_ZONE: la zona de tu instancia
- MY_INSTANCE: el nombre de tu instancia con la información pertinente.
Para copiar el contenido de la instancia antigua en un segmento de Cloud Storage, usa gcloud storage. El siguiente comando de ejemplo copia todos los archivos del cuaderno (.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
```
Crea una instancia de cuadernos gestionados por usuarios con las mismas especificaciones de hardware que la instancia antigua. Puedes crear la instancia con laGoogle Cloud consola o la CLI de Google Cloud.

En este ejemplo, Vertex AI Workbench crea una instancia de cuadernos gestionados por el usuario llamada new-notebook en el proyecto example con la imagen de TensorFlow 2 más reciente, con un tipo de máquina n1-standard-1 en la zona us-west1-a.

En Cloud Shell o en cualquier entorno en el que esté instalada Google Cloud CLI, introduce 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 nueva instancia de cuadernos gestionados por usuarios tiene dos discos. Tiene un disco de arranque y un disco de datos.
Usa ssh para conectarte a la instancia de cuadernos gestionados por usuarios que acabas de crear.
Para copiar el contenido de la instancia antigua del segmento de Cloud Storage a la nueva instancia, usa gcloud storage. El siguiente comando de ejemplo copia todos los archivos de cuaderno (.ipynb) del directorio de Cloud Storage al directorio /home/jupyter/ de la nueva instancia.
```
gcloud storage cp gs://my-bucket/legacy-notebooks/*.ipynb  /home/jupyter/ --recursive
```
En la nueva instancia de cuadernos gestionada por el usuario, abre JupyterLab y confirma que los datos y los recursos del usuario se han copiado correctamente.
Opcional: elimina la instancia antigua.

Registrar una instancia antigua con la API Notebooks

Para usar la API Notebooks y gestionar tus instancias antiguas, debes registrarlas con la API Notebooks.

Si habilitas la API Notebooks antes de registrar tus instancias antiguas, el proceso de activación de la API Notebooks intentará registrar automáticamente tus instancias antiguas. Si creas instancias antiguas después de habilitar la API Notebooks, debes registrarlas manualmente mediante uno de los siguientes métodos.

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

Consola

Para usar la opción Registrar todo en la consola Google Cloud , sigue estos pasos:

En la Google Cloud consola, ve a la página Notebooks gestionados por el usuario.

Ir a Cuadernos gestionados por usuarios
Si tienes una o varias instancias de cuadernos antiguos gestionados por el usuario, aparecerá un mensaje que indica que debes registrarlas con la API de Notebooks. Junto a este mensaje, haz clic en Registrar todo.
Si no tienes ninguna instancia de cuaderno antiguo gestionado por el usuario, pero aún no has habilitado la API Notebooks, haz clic en Habilitar API Notebooks para asegurarte de que las nuevas instancias de cuaderno gestionado por el usuario se creen con la API Notebooks.

API de Notebooks

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

gcloud notebooks instances register MY_INSTANCE_NAME \
    --location=MY_ZONE

Haz los cambios siguientes:

MY_INSTANCE_NAME: el nombre de tu instancia
MY_ZONE: la zona de tu instancia

Siguientes pasos

Crear una instancia de cuadernos gestionados por usuarios con un contenedor personalizado