Gestionar tiempos de ejecución

Gestionar tiempos de ejecución

En esta página se describe cómo gestionar un tiempo de ejecución de Colab Enterprise, incluidas las siguientes tareas:

• Inicia un entorno de ejecución.
• Detener un tiempo de ejecución.
• Desconectarse de un tiempo de ejecución.
• Vuelve a conectarte a un entorno de ejecución.
• Cambia el tiempo de ejecución al que estás conectado.
• Elimina un tiempo de ejecución.

Roles obligatorios

Para obtener los permisos que necesitas para gestionar un tiempo de ejecución de Colab Enterprise, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Usuario de Colab Enterprise (roles/aiplatform.colabEnterpriseUser) en el proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Uno o varios de los roles obligatorios incluyen el permiso dataform.repositories.list. Los usuarios a los que se les haya concedido el permiso dataform.repositories.list o el rol Creador de código (roles/dataform.codeCreator) en un proyecto pueden enumerar los nombres de los recursos de código de ese proyecto mediante la API de Dataform o la interfaz de línea de comandos (CLI) de Dataform. Los usuarios que no sean administradores y usen BigQuery Studio solo podrán ver los recursos de código que hayan creado o que se hayan compartido con ellos.

Iniciar un tiempo de ejecución

Para iniciar un tiempo de ejecución, puedes usar la Google Cloud consola, la CLI de gcloud o la API REST.

Consola

Para iniciar un entorno de ejecución, sigue estos pasos:

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

   Ir a Tiempos de ejecución

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

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

4. Haz clic en Empezar.

gcloud

Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

• RUNTIME_ID: el ID de tu tiempo de ejecución.
• PROJECT_ID: tu ID de proyecto.
• REGION: la región en la que se encuentra tu tiempo de ejecución.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

gcloud colab runtimes start RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

gcloud colab runtimes start RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

gcloud colab runtimes start RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

Para obtener más información sobre el comando para crear una plantilla de tiempo de ejecución desde la línea de comandos, consulta la documentación de la CLI de gcloud.

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• REGION: la región en la que se encuentra tu tiempo de ejecución.
• PROJECT_ID: tu ID de proyecto.
• RUNTIME_ID: el ID de tu tiempo 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

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Ejecuta el comando siguiente:

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

Nota: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Ejecuta el comando siguiente:

$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 la solicitud se completa correctamente, en el cuerpo de la respuesta se incluye una instancia de Operation.

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

Detener un tiempo de ejecución

Para detener un tiempo de ejecución, puedes usar la CLI de gcloud o la API REST.

gcloud

Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

• RUNTIME_ID: el ID de tu tiempo de ejecución.
• PROJECT_ID: tu ID de proyecto.
• REGION: la región en la que se encuentra tu tiempo de ejecución.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

gcloud colab runtimes stop RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

gcloud colab runtimes stop RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

gcloud colab runtimes stop RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

Para 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 la CLI de gcloud.

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• REGION: la región en la que se encuentra tu tiempo de ejecución.
• PROJECT_ID: tu ID de proyecto.
• RUNTIME_ID: el ID de tu tiempo 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

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Ejecuta el comando siguiente:

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

Nota: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Ejecuta el comando siguiente:

$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 la solicitud se completa correctamente, en el cuerpo de la respuesta se incluye una instancia de Operation.

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

Desconectarse de un entorno de ejecución

Para desconectarte de un tiempo de ejecución, sigue estos pasos:

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

   Ir a Mis cuadernos

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

3. Abre el cuaderno que quieras desconectar del tiempo de ejecución.

4. En la barra de herramientas del encabezado, haz clic en Tiempo de ejecución > Gestionar sesiones. Si no ves la barra de herramientas del encabezado, haz clic en  Mostrar u ocultar encabezado.

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

6. Haz clic en Terminar.

Volver a conectarse a un entorno de ejecución

Para volver a conectarte a un entorno de ejecución, sigue estos pasos:

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

   Ir a Mis cuadernos

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

3. Abre un cuaderno que se haya desconectado recientemente de un tiempo de ejecución.

4. En la esquina superior derecha del cuaderno, haz clic en Volver a conectar.

   Si el entorno de ejecución al que se había conectado el cuaderno anteriormente sigue en ejecución, Colab Enterprise se conectará a él. Si ese tiempo de ejecución ya no está en ejecución, se conecta al tiempo de ejecución predeterminado.

Cambiar el tiempo de ejecución

Para cambiar el tiempo de ejecución al que estás conectado, sigue estos pasos:

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

   Ir a Mis cuadernos

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

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

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

5. Completa el cuadro de diálogo para conectarte a un entorno de ejecución.

Eliminar un tiempo de ejecución

Para eliminar un tiempo de ejecución, puedes usar la Google Cloud consola, gcloud CLI o la API REST.

Consola

Para eliminar un tiempo de ejecución, sigue estos pasos:

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

   Ir a Tiempos de ejecución

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

3. Selecciona el tiempo de ejecución que quieras eliminar.

4. Haz clic en  Eliminar.

5. Haz clic en Confirmar.

gcloud

Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

• RUNTIME_ID: el ID de tu tiempo de ejecución.
• PROJECT_ID: tu ID de proyecto.
• REGION: la región en la que se encuentra tu tiempo de ejecución.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

gcloud colab runtimes delete RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

gcloud colab runtimes delete RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

Nota: Asegúrate de haber inicializado la CLI de Google Cloud con la autenticación y un proyecto ejecutando uno de los siguientes comandos: gcloud init; o gcloud auth login y gcloud config set project.

gcloud colab runtimes delete RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

Para obtener más información sobre el comando para crear una plantilla de tiempo de ejecución desde la línea de comandos, consulta la documentación de la CLI de gcloud.

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• REGION: la región en la que se encuentra tu tiempo de ejecución.
• PROJECT_ID: tu ID de proyecto.
• RUNTIME_ID: el ID de tu tiempo 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

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Ejecuta el comando siguiente:

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

Nota: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Ejecuta el comando siguiente:

$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 la solicitud se completa correctamente, en el cuerpo de la respuesta se incluye una instancia de Operation.

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

Siguientes pasos

• Consulta más información sobre los runtimes y las plantillas de runtime.
• Crea una plantilla de tiempo de ejecución.