Actualizar el entorno de una instancia de cuadernos gestionados por usuarios

Las instancias de cuadernos gestionados por el usuario 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 cuadernos gestionados por usuarios.

Motivos para cambiar a una edición superior

Puede que quieras actualizar el entorno de tu instancia de cuadernos gestionados por usuarios 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 cuadernos gestionados por usuarios:

  • Actualización automática: habilita la actualización automática al crear una instancia de cuadernos gestionados por usuarios. 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 cuadernos gestionados por usuarios cumple los requisitos para actualizarse, puedes hacerlo manualmente.

Requisitos y limitaciones

No se garantiza la retrocompatibilidad con tus cuadernos gestionados por el usuario. Crea una copia de tus datos antes de actualizar una instancia de cuadernos gestionados por usuarios.

Para determinar si puedes actualizar una instancia de cuadernos gestionados por el usuario concreta, 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.

  • La versión del entorno de la instancia de cuadernos gestionados por usuarios debe ser M54 o una posterior.

  • La instancia de cuadernos gestionados por usuarios debe haberse creado con la API Notebooks o registrado con la API Notebooks.

  • Si tu instancia de cuadernos gestionados por el usuario se basa 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 cuadernos gestionada por el usuario.

Cómo funciona la actualización

Las instancias de cuadernos gestionados por usuarios 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 cuadernos gestionados por usuarios 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 cuadernos gestionados por usuarios 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

Vertex AI Workbench actualiza los entornos con regularidad (consulta las notas de la versión de Deep Learning VM), 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 cuadernos gestionados por usuarios, consulta el artículo Crear una versión específica de una instancia de cuadernos gestionados por usuarios.

Antes de actualizar

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 isUpgradeable. 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 cuadernos gestionados por usuarios con la actualización automática habilitada

Para crear una instancia de cuadernos gestionados por usuarios 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 o la CLI de Google Cloud.

Antes de empezar

Para crear una instancia de cuadernos gestionada por el usuario, debes tener un proyectoGoogle Cloud y habilitar la API Notebooks en ese proyecto.
  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.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Notebooks API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Notebooks API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    8.

  8. Si tienes previsto usar GPUs con tu instancia de notebooks gestionados por el usuario, consulta la página de cuotas de la consola Google Cloud para asegurarte de que tienes suficientes GPUs disponibles en tu proyecto. Si las GPUs no aparecen en la página de cuotas o necesitas más cuota de GPU, puedes solicitar un aumento. Consulta la sección Solicitar un aumento de cuota de la página Cuotas de recursos de Compute Engine.

    9. Roles obligatorios

    Si has creado el proyecto, tienes el rol de gestión de identidades y accesos Propietario (roles/owner) en el proyecto, que incluye todos los permisos necesarios. Salta esta sección y empieza a crear tu instancia de cuadernos gestionados por usuarios. Si no has creado el proyecto tú mismo, sigue las instrucciones de esta sección.

    Para obtener los permisos que necesitas para crear una instancia de notebooks administrados por el usuario de Vertex AI Workbench, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en el proyecto:

    Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

    También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

    Crear la instancia

    Consola

    1. En la Google Cloud consola, ve a la página Notebooks gestionados por el usuario. También puedes ir a notebook.new (https://notebook.new) y saltarte el siguiente paso.

      Ir a Cuadernos gestionados por usuarios

    2. Haz clic en  Nuevo cuaderno y, a continuación, selecciona Personalizar.

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

      • Nombre: el nombre de 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 los cuadernos gestionados por usuarios disponibles.

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

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

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

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

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

    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 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

      Haz los cambios siguientes:

      • INSTANCE_NAME: el nombre de tu nueva instancia
      • SCHEDULE: la programación semanal o mensual que hayas definido en formato cron de Unix. Por ejemplo, "00 19 * * MON" significa semanalmente los lunes a las 19:00 (GMT).
      • VM_IMAGE_FAMILY: el nombre de la familia de imágenes que quieras usar para crear tu instancia
      • MACHINE_TYPE: el tipo de máquina de la VM de tu instancia
      • LOCATION: la Google Cloud ubicación en la que quieres que esté tu nueva instancia

    2. Accede a tu instancia desde la consolaGoogle Cloud .

    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 notebooks gestionados por el usuario, sigue estos pasos:

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

      Ir a Cuadernos gestionados por usuarios

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

    3. En la página Detalles del cuaderno, 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 cuadernos gestionados por usuarios 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 Google Cloud consola, ve a la página Notebooks gestionados por el usuario.

      Ir a Cuadernos gestionados por usuarios

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

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

    4. En la página Detalles del cuaderno, 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 cuadernos gestionados por usuarios en la Google Cloud consola o mediante la CLI de Google Cloud.

    Consola

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

      Ir a Cuadernos gestionados por usuarios

    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 del cuaderno, 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.

    gcloud

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

      Haz los cambios siguientes:

      • INSTANCE_NAME: el nombre de tu instancia
      • LOCATION: la Google Cloud ubicación 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 tu instancia no se está ejecutando, iníciala. Vertex AI Workbench solo puede actualizar instancias cuando están en ejecución.

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

    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.

    Restaurar una versión anterior

    Para revertir una actualización, sigue estos pasos:

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

      Ir a Cuadernos gestionados por usuarios

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

    3. En la página Detalles del cuaderno, vaya a Historial de actualizaciones y haga clic en Restaurar versión anterior.

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