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:

  1. En la consola de Google Cloud , ve a la página Entornos de ejecución de Colab Enterprise.

    Ir a Entornos de ejecución

  2. En el menú Región, selecciona la región que contiene tu entorno de ejecución.

  3. Selecciona el tiempo de ejecución que deseas iniciar.

  4. 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 proyecto
  • REGION: 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 proyecto
  • RUNTIME_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
Si se ejecuta correctamente, el cuerpo de la respuesta contiene una instancia de operación.

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 proyecto
  • REGION: 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 proyecto
  • RUNTIME_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
Si se ejecuta correctamente, el cuerpo de la respuesta contiene una instancia de operación.

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:

  1. En la consola de Google Cloud , ve a la página Mis notebooks de Colab Enterprise.

    Ir a Mis notebooks

  2. En el menú Región, selecciona la región que contiene el notebook.

  3. Abre el notebook que quieres desconectar del tiempo de ejecución.

  4. 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.

  5. En el panel Sesiones activas, haz clic en el botón  Finalizar sesión.

  6. 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:

  1. En la consola de Google Cloud , ve a la página Mis notebooks de Colab Enterprise.

    Ir a Mis notebooks

  2. En el menú Región, selecciona la región que contiene el notebook.

  3. Abre un notebook que se desconectó recientemente de un tiempo de ejecución.

  4. 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:

  1. En la consola de Google Cloud , ve a la página Mis notebooks de Colab Enterprise.

    Ir a Mis notebooks

  2. En el menú Región, selecciona la región que contiene el notebook.

  3. Abre un notebook conectado a un tiempo de ejecución.

  4. En la esquina superior derecha del notebook, haz clic en  Opciones de conexión adicionales > Cambiar el tipo de entorno de ejecución.

  5. 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:

  1. En la consola de Google Cloud , ve a la página Entornos de ejecución de Colab Enterprise.

    Ir a Entornos de ejecución

  2. En el menú Región, selecciona la región que contiene tu entorno de ejecución.

  3. Selecciona el tiempo de ejecución que deseas borrar.

  4. Haz clic en Borrar.

  5. 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 proyecto
  • REGION: 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 proyecto
  • RUNTIME_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
Si se ejecuta correctamente, el cuerpo de la respuesta contiene una instancia de operación.

Para obtener más información, consulta la documentación de la API de REST de notebookRuntimes.delete.

¿Qué sigue?