Migra de notebooks administrados a instancias de Vertex AI Workbench

En esta página, se describe cómo migrar de una instancia de notebooks administrados a una instancia de Vertex AI Workbench. Puedes migrar con la herramienta de migración de Vertex AI Workbench o migrar los datos y archivos de tu instancia de forma manual.

Descripción general de la herramienta de migración

Vertex AI Workbench proporciona una herramienta de migración para migrar de una instancia de notebooks administrada a una instancia de Vertex AI Workbench.

La herramienta de migración crea una instancia de Vertex AI Workbench con una configuración similar a la instancia de notebooks administrados que deseas migrar. Por ejemplo, la herramienta de migración crea una instancia que tiene el mismo tipo de máquina, la misma configuración de red, la misma configuración de apagado inactivo y otras especificaciones similares. Luego, los archivos del disco de datos de tu instancia de notebooks administrada se copian en la instancia de Vertex AI Workbench.

Vertex AI Workbench no borra ni cambia tu instancia de notebooks administrados, por lo que, después de la migración, puedes seguir usándola. Si ya no necesitas la instancia de notebooks administrados, bórrala para evitar que se generen más cargos por ella.

Facturación

Si tu instancia de notebooks administrada usa discos persistentes extremos, la migración genera cargos por operaciones de E/S. Consulta "IOPS aprovisionadas en extremo" en la sección de precios de Persistent Disk y de Hyperdisk de precios de discos.

Después de la migración, la instancia de notebooks administrados aún existe y genera cargos como antes. Si ya no necesitas la instancia de notebooks administrados, bórrala para evitar que se sigan generando cargos por ella.

Comportamientos predeterminados de la herramienta de migración

La herramienta de migración de Vertex AI Workbench intenta migrar tu instancia de notebooks administrada a una instancia de Vertex AI Workbench con especificaciones coincidentes. Cuando una especificación de tu instancia de notebooks administrados no está disponible en las instancias de Vertex AI Workbench, Vertex AI Workbench usa una especificación predeterminada cuando es posible. Cuando la herramienta de migración no puede migrar una especificación de tu instancia de notebooks administrados, no migra la instancia.

En la siguiente tabla, se enumeran algunos de los comportamientos de migración predeterminados clave de la herramienta de migración.

Especifica las opciones

En las siguientes secciones, se describen los casos en los que se requiere especificar una opción para migrar tu instancia de notebooks administrada a una instancia de Vertex AI Workbench.

Instancias que usan el modo de acceso de usuario único

Las instancias de notebooks administrados que usan el modo de acceso de usuario único deben migrarse a una instancia con la opción serviceAccount especificada. La instancia de Vertex AI Workbench que migras se restringe para acceder a JupyterLab al usuario único, pero usa una cuenta de servicio a fin de interactuar con los servicios y las APIs de Google Cloud.

Instancias que usan una VPC administrada por Google

Las instancias de notebooks administrados que usan una VPC administrada por Google deben migrar a una instancia con las opciones network y subnet especificadas. La opción de usar una VPC administrada por Google no es compatible con las instancias de Vertex AI Workbench, por lo que se debe especificar una red diferente.

Instancias que usan una secuencia de comandos posterior al inicio

Las instancias de notebooks administrados que usan una secuencia de comandos posterior al inicio deben migrarse a una instancia con la opción PostStartupScriptOption especificada. Usa esta opción para indicar si quieres omiterla o volver a ejecutarla en tu instancia nueva de Vertex AI Workbench.

Especificar la opción PostStartupScriptOption no es compatible con la consola de Google Cloud. Para especificar la opción PostStartupScriptOption cuando migres tu instancia de notebooks administrada, debes usar Google Cloud CLI o la API de REST.

Antes de comenzar

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Notebooks API.

   Enable the API

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Notebooks API.

   Enable the API

8. Si aún no lo hiciste, crea una instancia de notebooks administrados.

Roles obligatorios

Para asegurarte de que tu cuenta de usuario tenga los permisos necesarios para migrar una instancia de notebooks administrados a una de Vertex AI Workbench, pídele a tu administrador que le otorgue a tu cuenta de usuario lo siguiente: rol de IAM de ejecutor de notebooks (roles/notebooks.runner) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para migrar una instancia de notebooks administrados a una instancia de Vertex AI Workbench. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Es posible que tu administrador también pueda otorgar estos permisos a tu cuenta de usuario con roles personalizados o con otros roles predefinidos.

Verificación previa a la migración

Antes de migrar, verifica la elegibilidad de la instancia de notebooks administrada. Para ello, crea una lista de tus instancias y revisa el resultado en busca de advertencias o errores de migración.

Genera una lista de tus instancias

Para obtener una lista de las instancias de notebooks administradas que aún no se migraron, usa el método projects.locations.runtimes.list con el filtro migrated:false. Puedes enumerarlas con gcloud CLI o la API de REST:

gcloud notebooks runtimes list --project=PROJECT_ID \
    --location=LOCATION --filter=migrated:false --format=default

gcloud notebooks runtimes list --project=PROJECT_ID `
    --location=LOCATION --filter=migrated:false --format=default

gcloud notebooks runtimes list --project=PROJECT_ID ^
    --location=LOCATION --filter=migrated:false --format=default

GET https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/runtimes?filter=migrated:false

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/runtimes?filter=migrated:false"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/runtimes?filter=migrated:false" | Select-Object -Expand Content

Comprueba el resultado en busca de advertencias o errores

Si se detectan advertencias o errores de migración, el resultado del método projects.locations.runtimes.list incluye esta información.

Las advertencias aparecen cuando componentes específicos de la configuración de tu instancia de notebooks administrados no migran a la misma especificación en una instancia de Vertex AI Workbench. Por ejemplo, si tu instancia de notebooks administrados usa un acelerador que no es compatible, aparecerá una advertencia en el resultado. En este caso, la instancia se migra sin ningún acelerador. Puedes adjuntar aceleradores después de la migración. Revisa las advertencias en el resultado, ten en cuenta los comportamientos predeterminados de la herramienta de migración y evalúa si la herramienta de migración es aceptable para tu migración.

Uno o más errores en el resultado significan que no puedes migrar la instancia de notebooks administrados con la herramienta de migración. Debes migrar la instancia de forma manual.

Para obtener más información sobre las advertencias y los errores de migración, consulta las advertencias y los errores en la documentación de RuntimeMigrationEligibility.

Cómo migrar con la herramienta de migración

Puedes migrar tu instancia de notebooks administrados con la consola de Google Cloud, Google Cloud CLI o la API de REST.

gcloud notebooks runtimes migrate RUNTIME_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --network=NETWORK \
    --subnet=SUBNET \
    --service-account=SERVICE_ACCOUNT \
    --post-startup-script-option=POST_STARTUP_SCRIPT_OPTION

gcloud notebooks runtimes migrate RUNTIME_ID `
    --project=PROJECT_ID `
    --location=LOCATION `
    --network=NETWORK `
    --subnet=SUBNET `
    --service-account=SERVICE_ACCOUNT `
    --post-startup-script-option=POST_STARTUP_SCRIPT_OPTION

gcloud notebooks runtimes migrate RUNTIME_ID ^
    --project=PROJECT_ID ^
    --location=LOCATION ^
    --network=NETWORK ^
    --subnet=SUBNET ^
    --service-account=SERVICE_ACCOUNT ^
    --post-startup-script-option=POST_STARTUP_SCRIPT_OPTION

POST https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/runtimes/RUNTIME_ID:migrate

{
  "network": NETWORK,
  "subnet": SUBNET,
  "serviceAccount": SERVICE_ACCOUNT_EMAIL_ADDRESS,
  "postStartupScriptOption": (POST_STARTUP_SCRIPT_OPTION)
}

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/runtimes/RUNTIME_ID:migrate"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/runtimes/RUNTIME_ID:migrate" | Select-Object -Expand Content

Migra manualmente

Para migrar tu instancia a una instancia de Vertex AI Workbench de forma manual, considera usar los siguientes métodos:

• Usa Cloud Storage y la terminal: Copia tus datos y archivos a Cloud Storage y, luego, a otra instancia mediante la terminal.

• Usa GitHub: Copia tus datos y archivos a un repositorio de GitHub con la extensión de Git para JupyterLab.

En esta guía, se describe cómo migrar datos y archivos mediante Cloud Storage y la terminal.

Requisitos

Debes tener acceso a la terminal de tu instancia de notebooks administrados. El acceso a la terminal se establece de forma manual cuando creas una instancia. La configuración de acceso a la terminal no se puede cambiar después de que se crea la instancia.

Migra de forma manual mediante Cloud Storage y la terminal

Para migrar datos y archivos a una nueva instancia de Vertex AI Workbench con Cloud Storage y la terminal, completa lo siguiente.

1. Crea un bucket de Cloud Storage en el mismo proyecto en el que se encuentra la instancia de notebook administrada.

2. En ese mismo proyecto, crea una instancia de Vertex AI Workbench a la que migrarás tus datos. Cuando crees esta instancia, ten en cuenta lo siguiente:

   • Habilita el acceso a la terminal.
   • Especifica el tipo de máquina, la red y otras características para que coincidan con lo que necesitas.

3. En la interfaz de JupyterLab de tu instancia de notebook administrada, selecciona Archivo > Nuevo > Terminal para abrir una ventana de la terminal.

4. Usa gcloud CLI para copiar tus datos del usuario en un bucket de Cloud Storage. Con el siguiente comando de ejemplo, se copian todos los archivos del directorio /home/jupyter/ de la instancia a un directorio en un bucket de Cloud Storage.

   gcloud storage cp /home/jupyter/* gs://BUCKET_NAMEPATH --recursive

   Reemplaza lo siguiente:

   • BUCKET_NAME: El nombre de tu bucket de Cloud Storage.
   • PATH: La ruta de acceso al directorio en el que deseas copiar los archivos, por ejemplo: /copy/jupyter/.

5. En la interfaz de JupyterLab de tu nueva instancia de Vertex AI Workbench, selecciona Archivo > Nuevo > Terminal para abrir una ventana de la terminal.

6. Usa gcloud CLI para copiar tus datos en la instancia nueva. En el siguiente comando de ejemplo, se copian todos los archivos de un directorio de Cloud Storage al directorio /home/jupyter/ de tu instancia nueva.

   gcloud storage cp gs://BUCKET_NAMEPATH* /home/jupyter/

Confirma la migración

Después de la migración, la instancia de notebooks administrada original sigue funcionando como antes. Confirma que la migración se realizó correctamente antes de borrar la instancia original.

Borra la instancia de notebooks administrados

Si no necesitas la instancia de notebooks administrados desde la que migraste, bórala para evitar cargos adicionales por esa instancia.

1. En la consola de Google Cloud, ve a la página Notebooks administrados.

   Ir a Notebooks administrados

2. Selecciona la instancia que deseas borrar.

3. Haz clic en delete Borrar. (Según el tamaño de la ventana, puede que el botón Borrar esté en el menú de opciones de more_vert).

4. Para confirmar la acción, haz clic en Borrar.

Solucionar problemas

Para encontrar métodos para diagnosticar y resolver problemas de migración, consulta Solución de problemas de Vertex AI Workbench.

¿Qué sigue?

• Obtén más información sobre instancias de Vertex AI Workbench.