Actualiza el entorno de una instancia

Las instancias de Vertex AI Workbench son instancias de Deep Learning VM Image que tienen habilitados los entornos de notebooks de JupyterLab y están listas para usarse. En esta página, se describe cómo actualizar el entorno de una instancia de Vertex AI Workbench.

Motivos para actualizar

Es posible que desees actualizar el entorno de la instancia de Vertex AI Workbench 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 Vertex AI Workbench:

  • Actualización automática: Habilita la actualización automática cuando crees una instancia de Vertex AI Workbench. 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 existente de Vertex AI Workbench cumple con los requisitos para la actualización, puedes hacerlo de forma manual.

Requisitos y limitaciones

No se garantiza la retrocompatibilidad con Vertex AI Workbench. Haz una copia de tus datos antes de actualizar una instancia de Vertex AI Workbench.

Para determinar si puedes actualizar una instancia de Vertex AI Workbench específica, consulta los siguientes requisitos y limitaciones:

Si la actualización de tu instancia no es una opción para ti, considera migrar tus datos a una nueva instancia de Vertex AI Workbench.

Cómo funciona la actualización

Las instancias de Vertex AI Workbench que se pueden actualizar son de dos discos, uno de arranque y otro 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 Vertex AI Workbench que se actualizarán y los que se conservarán.

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 Vertex AI Workbench almacenan las bibliotecas pip y Conda en el disco de arranque, que se reemplazará 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

La instancia de Vertex AI Workbench tiene un número de versión del entorno que puedes verificar:

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

    Ir a Instancias

  2. En la lista de instancias, encuentra el número de versión del entorno de la instancia en la columna Versión.

Vertex AI Workbench actualiza los entornos con regularidad (consulta las notas de la versión de VM de aprendizaje profundo), 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 deseas obtener información sobre cómo usar una versión específica para crear una instancia de Vertex AI Workbench, consulta Crea una versión específica de una instancia de Vertex AI Workbench.

Antes de empezar

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 checkUpgradability. 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 Vertex AI Workbench con la actualización automática habilitada

Para crear una instancia de Vertex AI Workbench 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.

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

    Ir a Instancias

  2. Haz clic en  Crear nuevo.

  3. En el cuadro de diálogo Instancia nueva, haz clic en Opciones avanzadas.

  4. En el diálogo Crear instancia, en la sección Detalles, proporciona la siguiente información para tu instancia nueva:

    • Nombre: Proporciona un nombre para la instancia nueva.
    • Región y Zona: Elige 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 Vertex AI Workbench disponibles.

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

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

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

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

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

Edita el programa de actualización automática

Completa los siguientes pasos para editar el programa de actualización automática después de crear la instancia de Vertex AI Workbench:

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

    Ir a Instancias

  2. Haz clic en el nombre de la instancia que necesita el cambio de programación.

  3. En la página Detalles de la instancia, 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 Vertex AI Workbench que cumplan 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 Instancias.

    Ir a Instancias

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

  3. En la página Detalles de la instancia, junto a Detalles de la 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 de forma manual una instancia de Vertex AI Workbench en la consola de Google Cloud.

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

    Ir a Instancias

  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 de la instancia, haz clic en Actualizar.

  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.

Revierte una actualización

Para revertir una actualización, sigue estos pasos:

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

    Ir a Instancias

  2. Haz clic en el nombre de la instancia que deseas revertir.

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

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