Entornos de ejecución y plantillas de entorno de ejecución

En esta página, se describen los entornos de ejecución y las plantillas de entorno de ejecución para Colab Enterprise.

Un entorno de ejecución es una máquina virtual (VM) aprovisionada por Google que puede ejecutar el código en tu notebook (archivo IPYNB).

Una plantilla de entorno de ejecución es una configuración de VM que especifica un tipo de máquina y otras características de la VM, además de parámetros de configuración comunes, como la red y si se habilita el acceso público a Internet o no. Cuando creas un entorno de ejecución, su VM se crea según las especificaciones de una plantilla de entorno de ejecución.

Flujo de trabajo

Puedes crear un notebook de Colab Enterprise y ejecutar código en él sin necesidad de entender los entornos de ejecución. Cuando ejecutas tu código por primera vez, Colab Enterprise aprovisiona un entorno de ejecución predeterminado y ejecuta tu código en él. Colab Enterprise seguirá usando el entorno de ejecución predeterminado hasta que te conectes a otro.

¿Qué debes hacer para configurar un entorno de ejecución según tus necesidades específicas?

  1. Crea una plantilla de entorno de ejecución con la configuración que necesitas.

  2. Crea un entorno de ejecución basado en esa plantilla.

  3. Conéctate al entorno de ejecución desde tu notebook y ejecuta el código.

Entornos de ejecución

En esta sección, se describen las características de los tiempos de ejecución.

Entorno de ejecución predeterminado

Si no creas un entorno de ejecución, se creará uno sin aceleradores la primera vez que ejecutes código o te conectes al entorno de ejecución predeterminado. Puedes usar el entorno de ejecución predeterminado sin aceleradores o cambiar a un entorno de ejecución predeterminado que incluya aceleradores.

Cuando Colab Enterprise crea un entorno de ejecución predeterminado, primero crea una plantilla de entorno de ejecución predeterminada correspondiente. Tanto el tiempo de ejecución como la plantilla de tiempo de ejecución aparecen en la consola de Google Cloud , donde puedes obtener información sobre ellos.

Si usas entornos de ejecución predeterminados sin aceleradores, Colab Enterprise crea un entorno de ejecución predeterminado sin aceleradores y su plantilla de entorno de ejecución correspondiente, por proyecto y por región.

Si usas entornos de ejecución predeterminados con aceleradores, Colab Enterprise crea un entorno de ejecución predeterminado con aceleradores y su plantilla de entorno de ejecución correspondiente por proyecto y por región.

Especificaciones de entorno de ejecución predeterminado

Los tiempos de ejecución predeterminados y sus plantillas de tiempo de ejecución predeterminadas correspondientes incluyen las siguientes especificaciones:

Especificación Predeterminado Predeterminado con GPU
Versión de Python La versión más reciente disponible (actualmente, Python 3.12) La versión más reciente disponible (actualmente, Python 3.12)
Tipo de máquina e2-standard-4 Depende de la disponibilidad regional. Consulta las Especificaciones.
Accelerator Ninguno Depende de la disponibilidad regional. Consulta las Especificaciones.
Disco de arranque Disco persistente SSD de 100 GiB (pd-ssd) Disco persistente SSD de 100 GiB (pd-ssd)
Disco de datos Disco persistente estándar de 100 GiB (pd-standard) Depende de la disponibilidad regional. Consulta las Especificaciones.
Cierre inactivo Habilitado y configurado en 180 minutos Habilitado y configurado en 180 minutos
Red La red de nube privada virtual predeterminada de tu proyecto La red de nube privada virtual predeterminada de tu proyecto
Acceso público a Internet Habilitado Habilitado
Autenticación de credenciales del usuario final Habilitado Habilitado
Eliminación automática Se borran automáticamente 18 horas después de su creación. Se borran automáticamente 18 horas después de su creación.

Versiones de Python

A partir de mayo de 2025, cuando Colab Enterprise cree una plantilla de entorno de ejecución predeterminada, esta se configurará para usar la versión más reciente de Python (actualmente, Python 3.12). Esto significa que, cuando haya una nueva versión de Python disponible en Colab Enterprise, los nuevos entornos de ejecución creados a partir de la plantilla de entorno de ejecución predeterminada usarán la versión más reciente de Python.

Si tus plantillas de entorno de ejecución predeterminadas se crearon en mayo de 2025 o antes, es posible que estén configuradas para usar Python 3.10. Para actualizar una plantilla de entorno de ejecución predeterminada para que use la versión más reciente de Python, debes borrar la plantilla de entorno de ejecución predeterminada. Luego, cuando se cree una nueva plantilla de entorno de ejecución predeterminada, se configurará para usar la versión más reciente de Python.

Para actualizar la versión de Python de una plantilla de entorno de ejecución que creaste, consulta Cómo cambiar la versión de Python de una plantilla de entorno de ejecución.

La versión de Python de los entornos de ejecución existentes no cambia automáticamente, incluso cuando hay una nueva versión de Python disponible en Colab Enterprise. No se admite cambiar la versión de Python de un entorno de ejecución existente. En su lugar, debes crear un nuevo entorno de ejecución derivado de una plantilla de entorno de ejecución que use la versión de Python que desees.

Cómo cambiar la versión de Python de una plantilla del entorno de ejecución

Para cambiar la versión de Python de una plantilla de tiempo de ejecución, puedes usar la API de 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 plantilla de entorno de ejecución.
  • PROJECT_ID: el ID de tu proyecto
  • NOTEBOOK_RUNTIME_TEMPLATE_ID: Es el ID de tu plantilla de entorno de ejecución.
  • RELEASE_NAME: Es el nombre de la versión de la imagen que deseas usar. Por ejemplo, py311 es el nombre de la versión de la imagen de Python 3.11. Para establecer la imagen en Latest, deja RELEASE_NAME vacío.

Método HTTP y URL: 

PATCH https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name

Cuerpo JSON de la solicitud:

{
  softwareConfig: {
    colabImage: {
      releaseName: "RELEASE_NAME"
    }
  }
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name"

PowerShell

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name" | 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 notebookRuntimeTemplates.patch.

Los tiempos de ejecución son regionales

Los tiempos de ejecución son regionales y deben estar ubicados en la misma región que tu notebook.

Los entornos de ejecución son exclusivos para cada usuario

Los tiempos de ejecución son exclusivos para un usuario. No puedes compartir tus tiempos de ejecución con otras personas ni usar los de ellas. Incluso si compartes un notebook con alguien, esa persona no tendrá acceso a tu entorno de ejecución y deberá ejecutar el notebook en su propio entorno de ejecución.

Sin embargo, los usuarios pueden crear sus propios tiempos de ejecución basados en la misma plantilla de tiempo de ejecución. Consulta Las plantillas de entorno de ejecución se pueden compartir con los usuarios.

Administra los archivos de tu entorno de ejecución

Puedes acceder a los archivos de tu entorno de ejecución y modificarlos con el botón  Archivos en Colab Enterprise. También puedes subir archivos a tu entorno de ejecución.

Cuando se borra tu entorno de ejecución, se borran todos los archivos que subas. Si modificaste archivos, estos volverán a su estado original cuando se cree un nuevo tiempo de ejecución. Consulta el período de eliminación automática en la sección Especificaciones de tiempo de ejecución predeterminadas.

Los notebooks pueden compartir entornos de ejecución

Puedes conectar más de un notebook al mismo tiempo de ejecución, pero no se recomienda. Varios notebooks que comparten el mismo entorno de ejecución pueden causar problemas, como los siguientes:

  • Es posible que los notebooks se ejecuten con lentitud porque comparten los recursos de procesamiento del tiempo de ejecución.

  • El código de un notebook puede afectar el estado de la VM del entorno de ejecución para el otro notebook. Por ejemplo, si instalas la versión 1.3 de un paquete en un notebook, pero tu otro notebook requiere la versión 1.2, es posible que tengas una incompatibilidad de versiones cuando ejecutes el segundo notebook.

En lugar de ejecutar código de varios notebooks en el mismo entorno de ejecución, puedes crear un entorno de ejecución para cada notebook basado en la misma plantilla de entorno de ejecución. Consulta Cómo crear varios entornos de ejecución a partir de la misma plantilla de entorno de ejecución.

Cargos de tiempo de ejecución

Se te cobra por el procesamiento del tiempo de ejecución según el tipo de máquina y los aceleradores que uses. También se te cobra por el almacenamiento del disco de arranque y el disco de datos. Los discos de arranque y los discos de datos se borran cuando se borran los tiempos de ejecución.

Los entornos de ejecución siempre incluyen un disco persistente SSD de 100 GiB, además del disco de datos especificado en la plantilla del entorno de ejecución. El disco de arranque no se puede configurar.

Mientras se cierran los tiempos de ejecución, sucede lo siguiente:

  • No se generan cargos de procesamiento porque no hay uso de CPU ni GPU.
  • Se cobra el almacenamiento del disco de arranque y del disco de datos.

Para obtener más información, consulta los precios de Colab Enterprise.

Puedes crear varios entornos de ejecución a partir de la misma plantilla de entorno de ejecución

Puedes crear varios entornos de ejecución a partir de una sola plantilla de entorno de ejecución no predeterminada. De esta manera, puedes ejecutar varios notebooks en VMs con la misma configuración sin compartir los recursos de esa VM.

Plantillas de entornos de ejecución

En esta sección, se describen las características de las plantillas de tiempo de ejecución.

Las plantillas de entorno de ejecución son regionales

Las plantillas de entorno de ejecución son regionales. Cuando creas un tiempo de ejecución, este se encuentra en la misma región que la plantilla de tiempo de ejecución y solo se puede usar con notebooks en esa región.

Las plantillas de tiempo de ejecución se pueden compartir con los usuarios

Puedes compartir una plantilla de tiempo de ejecución con otros usuarios. De esta manera, cada usuario puede crear su propio entorno de ejecución basado en la misma plantilla de entorno de ejecución y, por lo tanto, varios usuarios pueden ejecutar el mismo notebook en la misma configuración de VM.

Para obtener más información, consulta Administra el acceso a una plantilla de entorno de ejecución.

Configuración

Las plantillas de entorno de ejecución determinan la configuración de la VM de tu entorno de ejecución. Puedes especificar cualquiera de los siguientes valores:

Región

Elige la región en la que se encuentra tu notebook. Los tiempos de ejecución creados a partir de plantillas de tiempo de ejecución se encuentran en la misma región que la plantilla de tiempo de ejecución. Para que el notebook ejecute código en el entorno de ejecución, ambos deben estar en la misma región.

Tipo de máquina

Puedes configurar el tipo de máquina de tu plantilla del entorno de ejecución. Para obtener información sobre los tipos de máquinas, consulta la guía de comparación y recursos de familias de máquinas.

Disco de datos

Puedes configurar el tipo y el tamaño del disco de datos en tu plantilla del entorno de ejecución.

Cuando se crea tu entorno de ejecución, también se incluye un disco de arranque. El disco de arranque es un disco persistente SSD de 100 GiB y no se puede configurar.

Aceleradores

Puedes agregar aceleradores a la configuración de la plantilla del entorno de ejecución. La disponibilidad del acelerador se basa en el tipo de máquina y la región.

Red

Especifica tu red o usa la red de nube privada virtual predeterminada del proyecto.

Cierre inactivo

Colab Enterprise habilita el cierre por inactividad de forma predeterminada. Este parámetro de configuración cierra tu instancia después de 180 minutos de inactividad. Puedes cambiar la cantidad de minutos de inactividad antes de la desactivación o puedes inhabilitar el cierre inactivo.

Acceso público a Internet

Para tener más control sobre la seguridad de tu notebook y otros recursos, puedes desactivar el acceso público a Internet. Si configuras tu plantilla de entorno de ejecución de esta manera, los notebooks que usen entornos de ejecución creados a partir de la plantilla de entorno de ejecución no tendrán acceso a Internet pública.

Autenticación de credenciales del usuario final

De forma predeterminada, las plantillas de entorno de ejecución usan la autenticación de credenciales de usuario final para otorgar a tu notebook acceso a las credenciales predeterminadas de la aplicación (ADC). Puedes usar este acceso a las ADC para ejecutar código en tu notebook que interactúe con Vertex AI y otros servicios de Google Cloud . Cuando se habilitan las credenciales de usuario final, tu notebook usa las credenciales de quien lo ejecuta para determinar el acceso a los recursos de Google Cloud .

Si no están habilitadas las credenciales del usuario final, puedes acceder a ADC autenticando al usuario a través del código de tu notebook. Para obtener más información, consulta la sección "Credenciales del usuario" en Configura ADC para un entorno de desarrollo local.

Cargos por plantillas de entorno de ejecución

No se aplican cargos por crear o almacenar plantillas de entorno de ejecución. Consulta también Cargos por tiempo de ejecución.

¿Qué sigue?