Actualiza el entorno de una instancia de notebook administrada por el usuario

Actualiza el entorno de una instancia de notebook administrada por el usuario

Los notebooks administrados por el usuario de Vertex AI Workbench están obsoletos. El 30 de enero de 2025, finalizará la compatibilidad con notebooks administrados por el usuario y se quitará la capacidad de crear instancias de notebooks administrados por el usuario. Las instancias existentes seguirán funcionando, pero los parches y las actualizaciones no estarán disponibles. Para seguir usando Vertex AI Workbench, te recomendamos migrar tus instancias de notebooks administrados por el usuario a instancias de Vertex AI Workbench.

Las instancias de notebooks administrados por el usuario de Vertex AI Workbench son instancias de Deep Learning VM Image con entornos de notebook de JupyterLab habilitadas y listas para usar. En esta página, se describe cómo actualizar el entorno de una instancia de notebooks administrada por el usuario.

Motivos para actualizar

Es posible que desees actualizar el entorno de la instancia de notebook administrada por el usuario por cualquiera de los siguientes motivos:

• Para usar funciones nuevas que solo están disponibles en una versión más reciente de tu entorno.

• Para beneficiarte de las actualizaciones de framework, las actualizaciones de paquetes y las correcciones de errores que se implementaron en una versión más reciente de tu entorno.

Métodos de actualización

Hay dos maneras de actualizar una instancia de notebooks administrada por el usuario:

• Actualización automática: Habilita la actualización automática cuando crees una instancia de notebooks administrada por el usuario. Durante un período recurrente que especifiques, Vertex AI Workbench verifica si tu instancia se puede actualizar y, de ser así, la actualiza.

• Actualización manual: si una instancia de notebook administrada por el usuario cumple con los requisitos para la actualización, puedes actualizarla manualmente.

Requisitos y limitaciones

No se garantiza la retrocompatibilidad con tus notebooks administrados por el usuario. Haz una copia de tus datos antes de actualizar una instancia de notebook administrada por el usuario.

Para determinar si puedes actualizar una instancia de notebooks específica administrada por el usuario, consulta los siguientes requisitos y limitaciones:

• La API de Notebooks debe estar habilitada en el proyecto de Google Cloud de la instancia. Para obtener más información, consulta Enumera servicios habilitados y Habilita una API.

• La versión del entorno de la instancia de notebooks administrada por el usuario debe ser M54 o una superior.

• La instancia de notebooks administrada por el usuario debió crearse con la API de Notebooks o debe estar registrada con la API de Notebooks.

• Si tu instancia de notebooks administrada por el usuario está basada en contenedores, Vertex AI Workbench actualiza el SO. La versión de la imagen depende de la imagen específica que extrae tu Dockerfile.

  Para asegurarte de que la actualización use la versión más reciente de la imagen, considera usar la etiqueta latest en tu Dockerfile.

Si la actualización de tu instancia no es una opción para ti, considera migrar tus datos a una nueva instancia de notebook administrada por el usuario.

Cómo funciona la actualización

Las instancias de notebooks administradas por el usuario que se pueden actualizar tienen dos discos, uno de arranque y uno de datos. El proceso de actualización actualiza el disco de arranque a una imagen nueva mientras conserva tus datos en el disco de datos.

¿Qué componentes se actualizan o conservan?

En la siguiente tabla, se muestran los componentes de tu instancia de notebooks administrada por el usuario que se actualizan y los que se conservan.

Componente	Resultado de la actualización
Frameworks de aprendizaje automático	Actualizado
Datos de aprendizaje automático	Se conservan
Dependencias preinstaladas	Actualizado
Bibliotecas instaladas por el usuario	De forma predeterminada, debe reinstalarse (consulta Bibliotecas instaladas por el usuario).
Archivos locales en el directorio /home/jupyter	Conservada
Archivos locales en cualquier otro directorio /home/	No se conservan
Paquetes de sistema operativo preinstalados	Actualizado
Paquetes de sistema operativo instalados por el usuario	No se conservan
Controladores de GPU	Actualizado
Notebooks	Se conservan
Parámetros de configuración del usuario	Se conservan

Bibliotecas instaladas por el usuario

De forma predeterminada, las instancias de notebooks administrados por el usuario almacenan bibliotecas pip y Conda en el disco de arranque, que se reemplazan durante una actualización. Cuando instalas bibliotecas pip, puedes incluir la marca --user para instalarlas en el directorio /home/jupyter/, en el que se conservan durante una actualización.

De forma predeterminada, si instalas bibliotecas pip o Conda en un kernel creado a partir de un contenedor personalizado, las bibliotecas solo persisten mientras se ejecuta el kernel. Cada vez que se reinicia el kernel, se deben reinstalar esas bibliotecas. Para instalar bibliotecas persistentes en un contenedor personalizado, incluye las instalaciones de la biblioteca en tu Dockerfile. Cuando instalas bibliotecas pip en un kernel creado a partir de un contenedor personalizado, puedes incluir la marca --user para que las bibliotecas se conserven hasta que se reinicie la instancia.

Versiones del entorno

Vertex AI Workbench actualiza los entornos con regularidad (consulta las notas de la versión de Deep Learning VM), aunque con cada versión publicada, no todos los entornos se actualizan. Vertex AI Workbench solo actualiza una instancia si existe una versión más reciente del entorno para la imagen de VM en la que se basa tu instancia.

Si quieres obtener información sobre cómo usar una versión específica para crear una instancia de notebooks administrada por el usuario, consulta Crea una versión específica de una instancia de notebooks administrada por el usuario.

Antes de actualizar

Antes de hacer la actualización, completa los siguientes pasos.

1. Revisa las notas de la versión para obtener información sobre las actualizaciones de versiones más recientes.

2. Haz una copia de tus datos como copia de seguridad.

Actualización automática

Vertex AI Workbench puede actualizar automáticamente las instancias que se están ejecutando. Si se detiene la instancia, no se actualizará de forma automática, incluso si habilitaste la actualización automática cuando la creaste.

Cuando habilitas las actualizaciones automáticas del entorno, especificas un período recurrente en el que Vertex AI Workbench verifica si la instancia se puede actualizar y, si puede, la actualiza.

El período que especificas se almacena como una entrada de metadatos notebook-upgrade-schedule en formato unix-cron, hora del meridiano de Greenwich (GMT)

Para verificar si una instancia se puede actualizar, Vertex AI Workbench usa el método de API isUpgradeable. Con este método, se verifica si hay una versión más reciente de la imagen en el disco de arranque de la instancia.

Si la instancia se puede actualizar, Vertex AI Workbench usa un método de actualización interno para actualizarla.

Crea una instancia de notebooks administrada por el usuario con la actualización automática habilitada

Para crear una instancia de notebooks administrada por el usuario con la actualización automática habilitada, elige la casilla de verificación Habilitar actualización automática del entorno y establece un programa cuando crees la instancia.

Puedes especificar la actualización automática mediante la consola de Google Cloud o Google Cloud CLI.

Antes de comenzar

Antes de crear una instancia de notebook administrada por el usuario, debes tener un proyecto de Google Cloud y habilitar la API de Notebooks para ese proyecto.

1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

2. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

   Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   Ir al selector de proyectos

3. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

4. Habilita la API de Notebooks.

   Habilita la API

5. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

   Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   Ir al selector de proyectos

6. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

7. Habilita la API de Notebooks.

   Habilita la API

8. Si planeas usar GPU con la instancia de AI Platform Notebooks, consulta la página de cuotas en la consola de Google Cloud para asegurarte de que tienes suficientes GPU disponibles en el proyecto. Si las GPU no están enumeradas en la página de cuotas o necesitas obtener más cuota de GPU, puedes solicitar un aumento de cuota. Consulta Solicita un aumento de la cuota en la página Cuotas de recursos de Compute Engine.

Roles obligatorios

Si creaste el proyecto, tienes el rol de IAM propietario (roles/owner) en el proyecto, que incluye todos los permisos necesarios. Omite esta sección y comienza a crear tu instancia de notebooks administrados por el usuario. Si tú no creaste el proyecto, continúa con esta sección.

Para garantizar que tu cuenta de usuario tenga los permisos necesarios para crear una instancia de notebooks administrados por el usuario de Vertex AI Workbench, pídele a tu administrador que otorgue a tu cuenta de usuario los siguientes roles de IAM en el proyecto:

• Administrador de notebooks (roles/notebooks.admin)
• Usuario de cuenta de servicio roles/iam.serviceAccountUser ()

Si quieres obtener más información para otorgar roles, consulta Administra el acceso.

Es posible que tu administrador también pueda otorgar a tu cuenta de usuario los permisos necesarios a través de roles personalizados o de otros roles predefinidos.

Crea la instancia

Consola

1. En la consola de Google Cloud, ve a la página Notebooks administrados por el usuario. O bien, dirígete a notebook.new (https://notebook.new) y omite el siguiente paso.

   Ir a Notebooks administrados por el usuario

2. Haz clic en Nuevo notebook y elige Personalizar.

3. En la página Crear un notebook administrado por el usuario, en la sección Detalles, proporciona la siguiente información para tu instancia nueva:

   • Nombre: un nombre para tu instancia nueva
   • Región y Zona: Selecciona una región y una zona para la instancia nueva. Para obtener el mejor rendimiento de red, elige la región que se encuentra más cerca de tu ubicación geográfica. Consulta las ubicaciones de notebooks administrados por el usuario disponibles.

4. En la sección Estado del sistema, elige Actualización automática del entorno.

5. Elige si deseas actualizar tu notebook Semana a semana o Mes a mes.

6. En el campo Día de la semana, elige la opción que desees.

7. En el campo Hora, elige una hora del día.

8. Completa el resto del diálogo de creación de la instancia y, luego, haz clic en Crear.

gcloud

1. Desde Cloud Shell o cualquier entorno en el que Google Cloud CLI esté instalado, escribe el siguiente comando de Google Cloud CLI:

   gcloud notebooks instances create INSTANCE_NAME
       --metadata=notebook-upgrade-schedule=SCHEDULE
       --vm-image-project=deeplearning-platform-release
       --vm-image-family=VM_IMAGE_FAMILY
       --machine-type=MACHINE_TYPE
       --location=LOCATION
   

   Reemplaza lo siguiente:

   • INSTANCE_NAME: nombre de tu instancia nueva
   • SCHEDULE: programación semanal o mensual que establezcas, en formato unix-cron; por ejemplo, "00 19 * * MON” significa semanalmente cada lunes , a las 1900 horas, hora del meridiano de Greenwich (GMT)
   • VM_IMAGE_FAMILY: nombre de la familia de imágenes que deseas usar para crear tu instancia
   • MACHINE_TYPE: tipo de máquina de la VM de tu instancia
   • LOCATION: ubicación de Google Cloud en la que deseas que se ubique tu instancia nueva

2. Accede a tu instancia desde la consola de Google Cloud.

Edita el programa de actualización automática

Para cambiar el programa de actualización automática después de crear la instancia de notebooks administrada por el usuario, completa los siguientes 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. Haz clic en el nombre de la instancia que necesita el cambio de programación.

3. En la página Detalles del notebook, en la sección Actualización automática del entorno, edita el programa.

4. Haz clic en Enviar para guardar los cambios.

Actualización manual

Puedes actualizar de forma manual las instancias de notebooks administradas por el usuario que cumplen con los requisitos.

Verifica si hay una versión más reciente del entorno de la instancia

Para verificar si hay una versión más reciente del entorno de la instancia disponible, accede a la instancia desde la consola de Google Cloud.

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 la instancia no se encuentra en ejecución, iníciala. Vertex AI Workbench solo puede actualizar instancias cuando se están ejecutando.

3. Haz clic en el nombre de la instancia de la que deseas verificar la disponibilidad de una versión del entorno más reciente.

4. En la página Detalles del notebook, junto a Detalles de VM, haz clic en Ver en Compute Engine.

   Si hay una versión más reciente del entorno disponible, aparecerá el mensaje “Esta instancia se debe actualizar”.

Actualiza el entorno de la instancia a una versión más reciente

Puedes actualizar una instancia de notebooks administrados por el usuario de forma manual en la consola de Google Cloud o mediante Google Cloud CLI.

Nota: Las actualizaciones pueden afectar las operaciones del usuario que se ejecutan.

Consola

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 la instancia no se encuentra en ejecución, iníciala. Vertex AI Workbench solo puede actualizar instancias cuando se ejecutan.

3. Haz clic en el nombre de la instancia que deseas actualizar.

4. En la página Detalles del notebook, haz clic en  Editar.

5. Asegúrate de haber creado una copia de los datos en tu instancia antes de continuar.

6. Después de crear una copia de seguridad de tus datos, haz clic en Actualizar. Vertex AI Workbench actualiza tu instancia y la inicia.

gcloud

1. Para verificar si una instancia se puede actualizar, usa el método de API isUpgradeable. Con este método, se verifica si hay una versión más reciente de la imagen en el disco de arranque de la instancia.

   gcloud notebooks instances is-upgradeable INSTANCE_NAME \
       --location=LOCATION
   

   Reemplaza lo siguiente:

   • INSTANCE_NAME: nombre de tu instancia
   • LOCATION: ubicación de Google Cloud en la que se encuentra tu instancia

   Si la instancia se puede actualizar, la respuesta es true. Si la respuesta es false, la instancia no se puede actualizar, pero puedes intentar migrar tus datos a una nueva instancia.

2. Si la instancia no se encuentra en ejecución, iníciala. Vertex AI Workbench solo puede actualizar instancias cuando se ejecutan.

3. Asegúrate de haber creado una copia de los datos en tu instancia antes de continuar.

4. Si la instancia se puede actualizar, usa el método de la API upgrade para actualizarla.

   gcloud notebooks instances upgrade INSTANCE_NAME \
       --location=LOCATION
   

   Vertex AI Workbench actualiza la instancia.

Revierte una actualización

Para revertir una actualización, 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. Haz clic en el nombre de la instancia que deseas revertir.

3. En la página Detalles del notebook, en Actualizar el historial, haz clic en Revertir.

4. Vertex AI Workbench revertirá tu instancia a la versión anterior.