Crear una versión específica de una instancia

En esta página se describe cómo crear una versión específica de una instancia de Vertex AI Workbench.

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

Para asegurarte de que tu instancia de Vertex AI Workbench tenga un software compatible con tu código o aplicación, puedes crear una versión específica.

Las imágenes de las instancias de Vertex AI Workbench 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 Vertex AI Workbench, consulta las notas de las versiones de Vertex AI.

Después de crear una versión específica de una instancia de Vertex AI Workbench, 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.

Antes de empezar

  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.

    Crear una versión específica

    Puedes crear una versión específica de una instancia de Vertex AI Workbench mediante la Google Cloud consola o la CLI de Google Cloud.

    Consola

    Para crear una versión específica de una instancia de Vertex AI Workbench, haz lo siguiente:

    1. Cuando crees una instancia, en la sección Entorno, selecciona Usar una versión anterior.

    2. Haz clic en la lista Versión y selecciona una versión. Las versiones se numeran con el formato M seguido del número de la versión, por ejemplo, M123.

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

      Vertex AI Workbench crea una instancia y la inicia automáticamente. Cuando la instancia esté lista para usarse, Vertex AI Workbench activará el enlace Abrir JupyterLab.

    gcloud

    Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

    • INSTANCE_NAME: el nombre de tu instancia de Vertex AI Workbench. Debe empezar por una letra seguida de un máximo de 62 letras minúsculas, números o guiones (-), y no puede acabar en guion.
    • PROJECT_ID: tu ID de proyecto
    • LOCATION: la zona en la que quieres que se encuentre tu instancia
    • VM_IMAGE_NAME: el nombre de la imagen. Para obtener una lista de los nombres de imagen disponibles, usa el comando get-config.
    • MACHINE_TYPE: el tipo de máquina de la máquina virtual de tu instancia

    • METADATA: metadatos personalizados que se aplicarán a esta instancia. Por ejemplo, para especificar un script posterior al inicio, puedes usar la etiqueta de metadatos post-startup-script con el siguiente formato: --metadata=post-startup-script=gs://BUCKET_NAME/hello.sh

    Ejecuta el siguiente comando:

    Linux, macOS o Cloud Shell

    gcloud workbench instances create INSTANCE_NAME \
    --project=PROJECT_ID \
    --location=LOCATION \
    --vm-image-project="cloud-notebooks-managed" \
    --vm-image-name=VM_IMAGE_NAME \
    --machine-type=MACHINE_TYPE \
    --metadata=METADATA

    Windows (PowerShell)

    gcloud workbench instances create INSTANCE_NAME `
    --project=PROJECT_ID `
    --location=LOCATION `
    --vm-image-project="cloud-notebooks-managed" `
    --vm-image-name=VM_IMAGE_NAME `
    --machine-type=MACHINE_TYPE `
    --metadata=METADATA

    Windows (cmd.exe)

    gcloud workbench instances create INSTANCE_NAME ^
    --project=PROJECT_ID ^
    --location=LOCATION ^
    --vm-image-project="cloud-notebooks-managed" ^
    --vm-image-name=VM_IMAGE_NAME ^
    --machine-type=MACHINE_TYPE ^
    --metadata=METADATA

    Para obtener más información sobre el comando para crear una instancia desde la línea de comandos, consulta la documentación de la CLI de gcloud.

    Vertex AI Workbench crea una instancia y la inicia automáticamente. Cuando la instancia esté lista para usarse, Vertex AI Workbench activará un enlace Abrir JupyterLab en la consola. Google Cloud

    Siguientes pasos