En esta página, se muestra cómo crear, iniciar y borrar un tiempo de ejecución en Vertex AI.
Puedes crear un entorno de ejecución para ejecutar código en un entorno de ejecución que tenga una configuración diferente a la predeterminada. Los entornos de ejecución se crean en función de una plantilla de entorno de ejecución, que incluye especificaciones como el tipo de máquina y el tamaño del disco.
Para obtener más información sobre los tiempos de ejecución, consulta Tiempos de ejecución y plantillas de tiempo de ejecución.
Antes de comenzar
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Vertex AI, Dataform, and Compute Engine APIs.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Vertex AI, Dataform, and Compute Engine APIs.
-
En la consola de Google Cloud , ve a la página Entornos de ejecución de Colab Enterprise.
-
En el menú Región, selecciona la región en la que deseas que se ejecute el entorno de ejecución. Debe estar en la misma región que el notebook que lo usa.
-
Haz clic en
Crear.Aparecerá el cuadro de diálogo Crear entorno de ejecución de Vertex AI.
-
En el menú Plantilla de entorno de ejecución, selecciona una plantilla de entorno de ejecución. Si no hay plantillas de entorno de ejecución enumeradas, crea una plantilla de entorno de ejecución.
-
En el campo Nombre del entorno de ejecución, ingresa un nombre para tu entorno de ejecución.
-
Haz clic en Crear.
DISPLAY_NAME
: Es el nombre visible de tu entorno de ejecución.RUNTIME_TEMPLATE_ID
: Es el ID de la plantilla de entorno de ejecución. La plantilla de entorno de ejecución especifica la configuración de procesamiento del entorno de ejecución.PROJECT_ID
: el ID de tu proyectoREGION
: Es la región en la que deseas que se encuentre tu entorno de ejecución.-
En la consola de Google Cloud , ve a la página Entornos de ejecución de Colab Enterprise.
-
En el menú Región, selecciona la región que contiene tu entorno de ejecución.
-
Selecciona el tiempo de ejecución que deseas iniciar.
-
Haz clic en Iniciar.
RUNTIME_ID
: Es el ID de tu entorno de ejecución.PROJECT_ID
: el ID de tu proyectoREGION
: Es la región en la que se encuentra tu entorno de ejecución.-
En la consola de Google Cloud , ve a la página Entornos de ejecución de Colab Enterprise.
-
En el menú Región, selecciona la región que contiene tu entorno de ejecución.
-
Selecciona el tiempo de ejecución que deseas borrar.
-
Haz clic en
Borrar. -
Haz clic en Confirmar.
RUNTIME_ID
: Es el ID de tu entorno de ejecución.PROJECT_ID
: el ID de tu proyectoREGION
: Es la región en la que se encuentra tu entorno de ejecución.- Crea un tiempo de ejecución en otra región.
- Crea una plantilla de entorno de ejecución con una configuración de tipo de máquina diferente y, luego, crea un entorno de ejecución basado en la nueva plantilla.
- Obtén más información sobre los entornos de ejecución y las plantillas de entorno de ejecución.
- Conéctate a tu entorno de ejecución.
- Obtén más información para crear una plantilla de entorno de ejecución.
Roles obligatorios
Para obtener los permisos que necesitas para crear un entorno de ejecución en Colab Enterprise, pídele a tu administrador que te otorgue el rol de IAM de administrador de Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin
) en el proyecto.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.
Crea un entorno de ejecución
Para crear un tiempo de ejecución, puedes usar la consola de Google Cloud o Google Cloud CLI.
Console
Para crear un entorno de ejecución, sigue estos pasos:
De forma predeterminada, cuando creas un entorno de ejecución, automáticamente tienes los permisos necesarios para iniciarlo y borrarlo.
gcloud
Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud colab runtimes create --display-name="DISPLAY_NAME" \ --runtime-template=RUNTIME_TEMPLATE_ID \ --project=PROJECT_ID \ --region=REGION
Windows (PowerShell)
gcloud colab runtimes create --display-name="DISPLAY_NAME" ` --runtime-template=RUNTIME_TEMPLATE_ID ` --project=PROJECT_ID ` --region=REGION
Windows (cmd.exe)
gcloud colab runtimes create --display-name="DISPLAY_NAME" ^ --runtime-template=RUNTIME_TEMPLATE_ID ^ --project=PROJECT_ID ^ --region=REGION
De forma predeterminada, cuando creas un entorno de ejecución, automáticamente tienes los permisos necesarios para iniciarlo y borrarlo.
Si deseas obtener más información sobre el comando para crear una plantilla de ejecución desde la línea de comandos, consulta la documentación de gcloud CLI.
Cómo iniciar un entorno de ejecución
Para iniciar un tiempo de ejecución, puedes usar la consola de Google Cloud o gcloud CLI.
Console
Para iniciar un entorno de ejecución, haz lo siguiente:
gcloud
Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud colab runtimes start RUNTIME_ID \ --project=PROJECT_ID \ --region=REGION
Windows (PowerShell)
gcloud colab runtimes start RUNTIME_ID ` --project=PROJECT_ID ` --region=REGION
Windows (cmd.exe)
gcloud colab runtimes start RUNTIME_ID ^ --project=PROJECT_ID ^ --region=REGION
Si deseas obtener más información sobre el comando para crear una plantilla de ejecución desde la línea de comandos, consulta la documentación de gcloud CLI.
Cómo borrar un entorno de ejecución
Para borrar un tiempo de ejecución, puedes usar la Google Cloud consola o gcloud CLI.
Console
Para borrar un tiempo de ejecución, haz lo siguiente:
gcloud
Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud colab runtimes delete RUNTIME_ID \ --project=PROJECT_ID \ --region=REGION
Windows (PowerShell)
gcloud colab runtimes delete RUNTIME_ID ` --project=PROJECT_ID ` --region=REGION
Windows (cmd.exe)
gcloud colab runtimes delete RUNTIME_ID ^ --project=PROJECT_ID ^ --region=REGION
Si deseas obtener más información sobre el comando para crear una plantilla de ejecución desde la línea de comandos, consulta la documentación de gcloud CLI.
Solucionar problemas
En esta sección, se muestra cómo resolver problemas con la creación de entornos de ejecución en Colab Enterprise.
No se pudo crear un entorno de ejecución
Este problema se produce cuando no puedes crear un entorno de ejecución. Consulta también No se puede crear un entorno de ejecución predeterminado. Las causas más comunes son las siguientes:
Cuota insuficiente
Si no puedes crear un entorno de ejecución, es posible que hayas excedido tu cuota de entorno de ejecución de Compute Engine.
Colab Enterprise usa la cuota de Compute Engine para los entornos de ejecución. Para obtener más información, consulta la descripción general de los límites y cuota de Compute Engine.
Para resolver este problema, solicita un ajuste de cuota.
Recursos no disponibles
El siguiente error ocurre cuando intentas crear un entorno de ejecución.
No available zone found for runtime RUNTIME_ID for machine type MACHINE_TYPE with accelerator type: ACCELERATOR. Please try again later.
Este error se produce si no hay recursos disponibles para la configuración del tipo de máquina dentro de la región de tu notebook.
Para resolver este problema, prueba una de las siguientes opciones:
Ya existe un entorno de ejecución predeterminado
El siguiente error se produce cuando intentas crear un entorno de ejecución a partir de la plantilla de entorno de ejecución predeterminada cuando ya existe el entorno de ejecución predeterminado.
Failed to create runtime One click runtime already exists.
Si intentas crear un entorno de ejecución a partir de una plantilla de entorno de ejecución predeterminada, Colab Enterprise intentará crear un entorno de ejecución predeterminado. Solo puede haber un tiempo de ejecución predeterminado por usuario, proyecto y región. Si ya existe el entorno de ejecución predeterminado, Colab Enterprise no puede crear otro.
Para resolver este problema, conéctate al entorno de ejecución predeterminado existente o crea uno a partir de una plantilla de entorno de ejecución no predeterminada.
No se pudo crear un tiempo de ejecución predeterminado
Cuando Colab Enterprise crea un entorno de ejecución predeterminado, primero crea una plantilla de entorno de ejecución predeterminada que usa para generar el entorno de ejecución predeterminado. Si intentas crear un entorno de ejecución predeterminado sin los permisos necesarios para crear una plantilla de entorno de ejecución, Colab Enterprise no podrá crear el entorno de ejecución predeterminado.
Para resolver este problema, pídele a tu administrador que te otorgue un rol que incluya el permiso aiplatform.notebookRuntimeTemplates.create
.