Actualizar el entorno de una instancia

Las instancias de Vertex AI Workbench son instancias de imágenes de máquina virtual de aprendizaje profundo con entornos de cuadernos de JupyterLab habilitados y listos para usar. En esta página se describe cómo actualizar el entorno de una instancia de Vertex AI Workbench.

Motivos para cambiar a una edición superior

Puede que quieras actualizar el entorno de tu instancia de Vertex AI Workbench por alguno de los siguientes motivos:

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

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

Métodos de mejora

Hay dos formas de actualizar una instancia de Vertex AI Workbench:

  • Actualización automática: habilita la actualización automática al crear una instancia de Vertex AI Workbench. Durante un periodo que especifiques, Vertex AI Workbench comprueba si se puede actualizar tu instancia y, si es así, la actualiza.

  • Actualización manual: si una instancia de Vertex AI Workbench cumple los requisitos para actualizarse, puedes hacerlo manualmente.

Requisitos y limitaciones

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

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

  • La API Notebooks debe estar habilitada en elGoogle Cloud proyecto de la instancia. Para obtener más información, consulta los artículos sobre cómo listar los servicios habilitados y habilitar una API.

  • Si tu instancia de Vertex AI Workbench está basada en contenedores, Vertex AI Workbench actualizará el SO. La versión de la imagen depende de la imagen específica extraída por tu Dockerfile.

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

Si no puedes actualizar tu instancia, te recomendamos que migres 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 tienen dos discos: uno de arranque y otro de datos. El proceso de actualización actualiza el disco de arranque a una nueva imagen y conserva los datos del disco de datos.

¿Qué componentes se actualizan o se conservan?

En la siguiente tabla se muestra qué componentes de tu instancia de Vertex AI Workbench se actualizan y cuáles se conservan.

Componente Resultado de la actualización
Frameworks de aprendizaje automático Actualizado
Datos de aprendizaje automático Conservado
Dependencias preinstaladas Actualizado
Bibliotecas instaladas por el usuario De forma predeterminada, se debe volver a instalar (consulta Bibliotecas instaladas por el usuario).
Archivos locales del directorio /home/jupyter Conservado
Archivos locales de cualquier otro directorio de /home/ No se conserva
Paquetes de sistema operativo preinstalados Actualizado
Paquetes de sistema operativo instalados por el usuario No se conserva
Controladores de GPU Actualizado
Notebooks Conservado
Configuraciones de usuario Conservado

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 sustituye durante una actualización. Cuando instales bibliotecas pip, puedes incluir la marca --user para instalarlas en el directorio /home/jupyter/, donde se conservarán 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 se conservarán mientras el kernel esté en ejecución. Cada vez que se reinicie el kernel, será necesario volver a instalar esas bibliotecas. Para instalar bibliotecas persistentes en un contenedor personalizado, incluye las instalaciones de la biblioteca en tu Dockerfile. Cuando instales 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 de entorno

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

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

    Ir a Instancias

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

Vertex AI Workbench actualiza los entornos con regularidad (consulta las notas de la versión de la máquina virtual de aprendizaje profundo), pero no todos los entornos se actualizan con cada versión. Vertex AI Workbench solo actualiza una instancia si hay una versión del entorno más reciente para la imagen de VM en la que se basa tu instancia.

Para obtener información sobre cómo usar una versión específica para crear una instancia de Vertex AI Workbench, consulta Crear una versión específica de una instancia de Vertex AI Workbench.

Antes de empezar

Antes de cambiar a una edición superior, completa los siguientes pasos.

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

  2. Crea una copia de seguridad de tus datos.

Actualizaciones automáticas

Vertex AI Workbench puede actualizar automáticamente las instancias que estén en ejecución. Si tu instancia está detenida, no se actualizará automáticamente, aunque hayas habilitado la actualización automática al crearla.

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

El periodo que especifiques se almacenará como una entrada de metadatos notebook-upgrade-schedule en formato unix-cron, hora del meridiano de Greenwich (GMT).

Para comprobar si se puede actualizar una instancia, Vertex AI Workbench usa el método de la API checkUpgradability. Este método comprueba 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.

Crear 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, selecciona la casilla Habilitar actualización automática del entorno y define una programación al crear la instancia.

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

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

    Ir a Instancias

  2. Haz clic en  Crear.

  3. En el cuadro de diálogo Nueva instancia, haz clic en Opciones avanzadas.

  4. En el cuadro de diálogo Crear instancia, vaya a la sección Detalles y proporcione la siguiente información sobre la nueva instancia:

    • Nombre: asigna un nombre a la nueva instancia.
    • Región y Zona: selecciona una región y una zona para la nueva instancia. Para obtener el mejor rendimiento de red, selecciona la región que esté geográficamente más cerca de ti. Consulta las ubicaciones de Vertex AI Workbench disponibles.

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

  6. Elige si quieres actualizar tu cuaderno semanalmente o mensualmente.

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

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

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

Editar la programación de la actualización automática

Para editar la programación de actualización automática después de haber creado tu instancia de Vertex AI Workbench, sigue estos pasos:

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

    Ir a Instancias

  2. Haga clic en el nombre de la instancia cuya programación quiera cambiar.

  3. En la página Detalles de la instancia, en la sección Actualización automática del entorno, edita la programación.

  4. Haz clic en Enviar para guardar los cambios.

Actualización manual

Puedes actualizar manualmente las instancias de Vertex AI Workbench que cumplan los requisitos.

Buscar una versión más reciente del entorno de tu instancia

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

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

    Ir a Instancias

  2. Haga clic en el nombre de la instancia cuya disponibilidad de una versión de entorno más reciente quiera comprobar.

  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, aparece el mensaje "Esta instancia debe actualizarse".

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

Puedes actualizar manualmente una instancia de Vertex AI Workbench en la Google Cloud consola.

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

    Ir a Instancias

  2. Si tu instancia no se está ejecutando, iníciala. Vertex AI Workbench solo puede actualizar instancias cuando están en ejecución.

  3. Haga clic en el nombre de la instancia que quiera actualizar.

  4. En la página Detalles de la instancia, haz clic en  Actualizar.

  5. Antes de continuar, asegúrate de haber hecho una copia de los datos de tu instancia.

  6. Una vez que se hayan creado las copias de seguridad de tus datos, haz clic en Actualizar. Vertex AI Workbench actualiza e inicia tu instancia.

Restaurar una versión anterior

Para revertir una actualización, sigue estos pasos:

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

    Ir a Instancias

  2. Haga clic en el nombre de la instancia a la que quiera volver.

  3. En la página Detalles de la instancia, en Historial de actualizaciones, haz clic en Restaurar versión anterior.

  4. Vertex AI Workbench restaura la versión anterior de la instancia.