Crear una versión específica de una instancia de cuadernos gestionados por usuarios

En esta página se describe cómo puedes crear una instancia de cuadernos gestionados por usuarios basada en una versión específica de imágenes de máquina virtual de aprendizaje profundo.

Por qué puede ser útil crear una versión específica

Para asegurarte de que tu instancia de cuaderno gestionada por el usuario tenga un software compatible con tu código o aplicación, puedes crear una versión específica.

Las instancias de cuadernos gestionados por usuarios se crean mediante imágenes de máquinas virtuales de aprendizaje profundo. Las imágenes de Deep Learning VM se actualizan con frecuencia y las versiones específicas del software y los paquetes preinstalados varían de una versión a otra.

Para obtener más información sobre versiones específicas de Deep Learning VM, consulta las notas de la versión de Deep Learning VM.

Después de crear una versión específica de una instancia de cuadernos gestionados por usuarios, puedes actualizarla. Al actualizar la instancia, se actualizan el software y los paquetes preinstalados. Para obtener más información, consulta Actualizar el entorno de una instancia de cuadernos gestionados por usuarios.

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.

    Busca la versión específica que quieras

    Para crear una instancia de cuadernos gestionados por el usuario basada en una versión específica de Deep Learning VM, debes conocer el nombre de la imagen de la versión de Deep Learning VM que quieras usar.

    Cada lanzamiento de Deep Learning VM incluye actualizaciones de muchas imágenes diferentes, y cada imagen del lanzamiento tiene su propio nombre.

    Para encontrar el nombre de la imagen que quieras, sigue estos pasos:

    1. Busca el número de versión de la imagen de máquina virtual de aprendizaje profundo de la que quieras obtener los nombres de las imágenes. Los números de versión se incluyen en las notas de la versión de Deep Learning VM. Los números de versión tienen el formato M seguido del número de la versión (por ejemplo, M79).

    2. Para enumerar los nombres de las imágenes de máquina virtual de aprendizaje profundo de una versión específica, ejecuta el siguiente comando.

      gcloud compute images list --project="deeplearning-platform-release" \
    --format="value(name)" \
    --filter="labels.release=RELEASE_NUMBER" \
    --show-deprecated

      Sustituye RELEASE_NUMBER por un número de versión de Deep Learning VM, como M79.

    3. Busca el nombre de la imagen que quieras usar.

    Crear una versión específica desde la línea de comandos

    Para crear una versión específica de una instancia de cuadernos gestionados por usuarios desde la línea de comandos, sigue estos pasos:

    1. Ejecuta el siguiente comando gcloud notebooks:

      gcloud notebooks instances create INSTANCE_NAME \
    --vm-image-project="deeplearning-platform-release" \
    --vm-image-name=VM_IMAGE_NAME \
    --machine-type=MACHINE_TYPE \
    --location=LOCATION

      Haz los cambios siguientes:

      • INSTANCE_NAME: el nombre de tu nueva instancia
      • VM_IMAGE_NAME: el nombre de la imagen 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 Google Cloud consola.

    Siguientes pasos