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

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:

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 Se conservan
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. 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.

  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.

  8. Si planeas usar GPU con la instancia de notebooks administrados por el usuario, 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 administradas por el usuario. Si tú no creaste el proyecto, quédate en 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:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

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

Console

  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 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 una instancia de notebooks administrados por el usuario de forma manual en la consola de Google Cloud o mediante Google Cloud CLI.

Console

  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.