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 Agent Platform Workbench de Gemini Enterprise.

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 Agent Platform Workbench tenga un software compatible con tu código o aplicación.

Las imágenes de las instancias de Agent Platform 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 Agent Platform Workbench, consulta las notas de la versión de Agent Platform.

Después de crear una versión específica de una instancia de Agent Platform 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. Accede a tu Google Cloud cuenta de. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

  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 role (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 role (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.

Crea una versión específica

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

Console

Para crear una versión específica de una instancia de Agent Platform 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.

    Agent Platform Workbench crea una instancia y la inicia de forma automática. Cuando la instancia está lista para usarse, Agent Platform 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 Agent Platform 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: Es el ID del 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.

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

¿Qué sigue?