Cierre inactivo

Cierre inactivo

Los entornos de ejecución de Colab Enterprise se cierran después de 180 minutos de inactividad de forma predeterminada. En esta página, se describe la función de cierre inactivo y cómo cambiar su configuración predeterminada o desactivarla cuando creas una plantilla de entorno de ejecución.

Descripción general

Para ayudar a administrar los costos, los entornos de ejecución de Colab Enterprise se cierran de forma predeterminada después de estar inactivos durante un período específico. Puedes cambiar el tiempo o desactivar esta función cuando creas una plantilla de entorno de ejecución.

Después de crear una plantilla de entorno de ejecución, no se puede cambiar su configuración. Por lo tanto, no puedes cambiar la configuración de cierre inactivo de un entorno de ejecución o una plantilla de entorno de ejecución. Para usar un entorno de ejecución con diferentes parámetros de configuración de cierre inactivo, debes crear una plantilla de entorno de ejecución con la configuración que desees y, luego, usar un entorno de ejecución generado a partir de esa plantilla.

Antes de comenzar

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.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Vertex AI, Dataform, and Compute Engine APIs.

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 APIs

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Vertex AI, Dataform, and Compute Engine APIs.

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 APIs

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 administrador de Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) de IAM 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 a través de roles personalizados o cualquier otro rol predefinido.

Uno o más de los roles necesarios incluyen el permiso dataform.repositories.list. Los usuarios a los que se les otorgó el permiso dataform.repositories.list o el rol Creador de código (roles/dataform.codeCreator) en un proyecto pueden enumerar los nombres de los elementos 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 son administradores que usan BigQuery Studio solo pueden ver los elementos de código que crearon o que se compartieron con ellos.

Crea una plantilla de entorno de ejecución con parámetros de configuración de cierre inactivo específicos

Para crear una plantilla de entorno de ejecución con parámetros de configuración de cierre inactivo específicos, puedes usar la Google Cloud consola de o la CLI de Google Cloud.

Console

Para crear una plantilla de entorno de ejecución con parámetros de configuración de cierre inactivo específicos, sigue estos pasos:

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

   Ir a Plantillas de entorno de ejecución

2. Haz clic en Plantilla nueva.

   Aparecerá el cuadro de diálogo Crear nueva plantilla de entorno de ejecución.

3. En la sección Conceptos básicos del entorno de ejecución, ingresa un Nombre visible.

4. En el menú Región, selecciona la región en la que deseas que se ejecute el entorno de ejecución.

5. Para cambiar la configuración de cierre inactivo, haz clic en la sección Configurar procesamiento y completa el siguiente paso.

6. En la sección Cierre inactivo , haz lo siguiente:

   • Para desactivar el cierre inactivo, borra Habilitar el cierre inactivo.

   • Para cambiar el período de inactividad, en Tiempo de inactividad antes del cierre (Minutos), cambia la cifra a la cantidad de minutos de inactividad que deseas. En la Google Cloud consola, esta configuración se puede establecer con cualquier valor de número entero entre 10 y 1440.

7. En la sección Entorno, selecciona un Entorno. La opción predeterminada es Más reciente (actualmente Python 3.12).

8. Opcional: En el campo Secuencia de comandos posterior al inicio, ingresa el URI de una secuencia de comandos posterior al inicio. Para obtener más información sobre el uso de una secuencia de comandos posterior al inicio, consulta Usa una secuencia de comandos posterior al inicio.

9. Opcional: En la URL de la secuencia de comandos posterior al inicio, selecciona el comportamiento de la secuencia de comandos posterior al inicio. El comportamiento predeterminado es Ejecutar una vez. Para obtener más información, consulta Comportamiento de la secuencia de comandos posterior al inicio.

10. Opcional: Para agregar una variable de entorno, haz clic en  Agregar variable de entorno, y, luego, ingresa un par de Clave y Valor. Para agregar más variables de entorno, repite este paso.

11. Haz clic en Continuar.

12. Completa el resto del diálogo de creación.

13. Haz clic en Crear para terminar de crear la plantilla de entorno de ejecución.

    Tu plantilla de entorno de ejecución aparece en la lista en la pestaña Plantillas de entorno de ejecución.

gcloud

Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

• DISPLAY_NAME: el nombre visible de tu plantilla de entorno de ejecución
• INACTIVITY_DURATION: la duración de la inactividad antes de que se cierre el entorno de ejecución. Una entrada de 0s desactiva la función de cierre inactivo. El rango de valores válidos es de 10 minutos (10m) a 24 horas (24h).
• PROJECT_ID: el ID de tu proyecto
• REGION: la región en la que deseas que se ejecute el entorno de ejecución

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

gcloud colab runtime-templates create --display-name=DISPLAY_NAME \
    --idle-shutdown-timeout=INACTIVITY_DURATION \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

gcloud colab runtime-templates create --display-name=DISPLAY_NAME `
    --idle-shutdown-timeout=INACTIVITY_DURATION `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

gcloud colab runtime-templates create --display-name=DISPLAY_NAME ^
    --idle-shutdown-timeout=INACTIVITY_DURATION ^
    --project=PROJECT_ID ^
    --region=REGION

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

Cómo funciona el cierre inactivo

El entorno de ejecución se cierra cuando se cumplen las siguientes condiciones:

• No hay actividad de kernel durante el período especificado.

• El entorno de ejecución no está conectado a un notebook.

Para desconectar un entorno de ejecución de un notebook, cierra el notebook. Si dejas un notebook abierto mientras está conectado a un entorno de ejecución, se impide que se cierre.

Para obtener información sobre los cargos generados por los entornos de ejecución, consulta Cargos del entorno de ejecución.

¿Qué sigue?

• Obtén más información sobre los entornos de ejecución y las plantillas de entorno de ejecución.
• Aprende a crear un entorno de ejecución basado en una plantilla del entorno de ejecución.
• Para encontrar un notebook que te ayude a comenzar tu proyecto rápidamente, consulta la galería de notebooks.