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é deberías crear una versión específica

Te recomendamos 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.

Las imágenes de las instancias de Vertex AI Workbench se actualizan con frecuencia, y las versiones específicas de software y paquetes preinstalados varían de una versión a otra.

Para obtener más información sobre las versiones específicas de Vertex AI Workbench, consulta las notas de la versión de Vertex AI.

Después de crear una versión específica de una instancia de Vertex AI Workbench, puedes actualizarla. Con la actualización de la instancia se actualizan el software y los paquetes preinstalados. Para obtener más información, consulta Actualiza el entorno de una instancia.

Antes de comenzar

  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.

Crea una versión específica

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

Console

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

  1. Cuando creas 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 están numeradas con el formato M seguido del número de la versión, por ejemplo, M123.

  3. Completa el resto del diálogo de creación de la instancia y, luego, haz clic en Crear.

    Vertex AI Workbench crea una instancia y la inicia de forma automática. Cuando la instancia está lista para usarse, Vertex AI Workbench activa un vínculo Abrir JupyterLab.

gcloud

Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

  • INSTANCE_NAME: el nombre de tu instancia de Vertex AI Workbench. Debe comenzar con una letra seguida de un máximo de 62 letras minúsculas, números o guiones (-) y no puede terminar con un guion.
  • PROJECT_ID: el ID de tu proyecto
  • LOCATION: Es la zona en la que deseas que se ubique la instancia.
  • VM_IMAGE_NAME: Es 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 VM de tu instancia

  • METADATA: Son metadatos personalizados que se aplicarán a esta instancia. Por ejemplo, para especificar una secuencia de comandos posterior al inicio, puedes usar la etiqueta de metadatos post-startup-script en el 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

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

Vertex AI Workbench crea una instancia y la inicia de forma automática. Cuando la instancia está lista para usarse, Vertex AI Workbench activa un vínculo Abrir JupyterLab en la consola de Google Cloud.

¿Qué sigue?