Administrar entornos de ejecución
En esta página, se describe cómo administrar un entorno de ejecución de Colab Enterprise, incluidas las siguientes tareas:
- Inicia un entorno de ejecución.
- Detiene un entorno de ejecución.
- Desconéctate de un tiempo de ejecución.
- Vuelve a conectarte a un entorno de ejecución.
- Cambia el entorno de ejecución al que estás conectado.
- Borra un entorno de ejecución.
Roles obligatorios
Para obtener los permisos que necesitas para administrar un entorno de ejecución de Colab Enterprise, pídele a tu administrador que te otorgue el rol de IAM de usuario de Colab Enterprise (roles/aiplatform.colabEnterpriseUser
) 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.
Cómo iniciar un entorno de ejecución
Para iniciar un tiempo de ejecución, puedes usar la Google Cloud consola, gcloud CLI o la API de REST.
Console
Para iniciar un entorno de ejecución, haz lo siguiente:
-
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.
gcloud
Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:
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.
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.
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
REGION
: Es la región en la que se encuentra tu entorno de ejecución.PROJECT_ID
: el ID de tu proyectoRUNTIME_ID
: Es el ID de tu entorno de ejecución.
Método HTTP y URL:
POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente comando:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start"
PowerShell
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start" | Select-Object -Expand Content
Para obtener más información, consulta la documentación de la API de REST de notebookRuntimes.start
.
Cómo detener un entorno de ejecución
Para detener un tiempo de ejecución, puedes usar gcloud CLI o la API de REST.
gcloud
Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:
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.
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud colab runtimes stop RUNTIME_ID \ --project=PROJECT_ID \ --region=REGION
Windows (PowerShell)
gcloud colab runtimes stop RUNTIME_ID ` --project=PROJECT_ID ` --region=REGION
Windows (cmd.exe)
gcloud colab runtimes stop RUNTIME_ID ^ --project=PROJECT_ID ^ --region=REGION
Si deseas obtener más información sobre el comando para detener un tiempo de ejecución desde la línea de comandos, consulta la documentación de gcloud CLI.
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
REGION
: Es la región en la que se encuentra tu entorno de ejecución.PROJECT_ID
: el ID de tu proyectoRUNTIME_ID
: Es el ID de tu entorno de ejecución.
Método HTTP y URL:
POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente comando:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start"
PowerShell
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start" | Select-Object -Expand Content
Para obtener más información, consulta la documentación de la API de REST de notebookRuntimes.stop
.
Desconéctate de un entorno de ejecución
Para desconectarte de un tiempo de ejecución, haz lo siguiente:
-
En la consola de Google Cloud , ve a la página Mis notebooks de Colab Enterprise.
-
En el menú Región, selecciona la región que contiene el notebook.
-
Abre el notebook que quieres desconectar del tiempo de ejecución.
-
En la barra de herramientas del encabezado, haz clic en Runtime > Manage sessions. Si no ves la barra de herramientas del encabezado, haz clic en Activar o desactivar la visibilidad del encabezado.
-
En el panel Sesiones activas, haz clic en el botón
Finalizar sesión. -
Haz clic en Terminate.
Vuelve a conectarte a un entorno de ejecución
Para volver a conectarte a un entorno de ejecución, sigue estos pasos:
-
En la consola de Google Cloud , ve a la página Mis notebooks de Colab Enterprise.
-
En el menú Región, selecciona la región que contiene el notebook.
-
Abre un notebook que se desconectó recientemente de un tiempo de ejecución.
-
En la esquina superior derecha del notebook, haz clic en Volver a conectar.
Si el entorno de ejecución al que se conectó el notebook anteriormente sigue en ejecución, Colab Enterprise se conecta a él. Si ese entorno de ejecución ya no está en ejecución, se conecta al entorno de ejecución predeterminado.
Cómo cambiar el tiempo de ejecución
Para cambiar el entorno de ejecución al que estás conectado, haz lo siguiente:
-
En la consola de Google Cloud , ve a la página Mis notebooks de Colab Enterprise.
-
En el menú Región, selecciona la región que contiene el notebook.
-
Abre un notebook conectado a un tiempo de ejecución.
-
En la esquina superior derecha del notebook, haz clic en > Cambiar el tipo de entorno de ejecución.
Opciones de conexión adicionales -
Completa el diálogo para conectarte a un entorno de ejecución.
Cómo borrar un entorno de ejecución
Para borrar un tiempo de ejecución, puedes usar la Google Cloud consola, gcloud CLI o la API de REST.
Console
Para borrar un tiempo de ejecución, haz lo siguiente:
-
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.
gcloud
Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:
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.
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.
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
REGION
: Es la región en la que se encuentra tu entorno de ejecución.PROJECT_ID
: el ID de tu proyectoRUNTIME_ID
: Es el ID de tu entorno de ejecución.
Método HTTP y URL:
DELETE https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente comando:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID"
PowerShell
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID" | Select-Object -Expand Content
Para obtener más información, consulta la documentación de la API de REST de notebookRuntimes.delete
.
¿Qué sigue?
- Obtén más información sobre los entornos de ejecución y las plantillas de entorno de ejecución.
- Crea una plantilla de entorno de ejecución.