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 continúa usando el entorno de ejecución predeterminado hasta que te conectas a uno diferente.

¿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 necesites.

  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 entornos 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 entorno de ejecución como la plantilla de entorno de ejecución aparecen en la Google Cloud consola, 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 entornos de ejecución predeterminados y sus plantillas de entorno de ejecución predeterminadas correspondientes incluyen las siguientes especificaciones:

Especificación Predeterminado Predeterminado con GPU
Versión de Python La última disponible (actualmente Python 3.12) La última disponible (actualmente Python 3.12)
Tipo de máquina e2-standard-4 Depende de la disponibilidad regional. Consulta Especificaciones.
Accelerator Ninguno Depende de la disponibilidad regional. Consulta 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 Especificaciones.
Cierre inactivo Habilitado, configurado en 180 minutos Habilitado, configurado en 180 minutos
Red La red predeterminada de nube privada virtual de tu proyecto La red predeterminada de nube privada virtual de tu proyecto
Acceso a Internet pública Habilitado Habilitado
Autenticación de credenciales de usuario final Habilitado Habilitado
Eliminación automática Eliminación automática 18 horas después de la creación Eliminación automática 18 horas después de la 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 versión nueva de Python disponible en Colab Enterprise, los entornos de ejecución nuevos 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 Administra plantillas 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 versión nueva de Python disponible en Colab Enterprise. No se admite el cambio de la versión de Python de un entorno de ejecución existente. En su lugar, debes crear un entorno de ejecución nuevo derivado de una plantilla de entorno de ejecución que use la versión de Python que desees.

Cambia la versión de Python de una plantilla de entorno de ejecución

Para cambiar la versión de Python de una plantilla de entorno de ejecución, puedes usar la Google Cloud consola o la API de REST.

Console

Para editar una plantilla de entorno de ejecución, haz lo siguiente:

  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. En el menú Región, selecciona la región que contiene tu plantilla de entorno de ejecución.

  3. En la columna ID, haz clic en el número de ID de la plantilla de entorno de ejecución que deseas editar.

  4. Haz clic en  Editar.

  5. En el panel Editar plantilla de entorno de ejecución, realiza cambios en la plantilla de entorno de ejecución.

  6. Haz clic en Actualizar.

REST

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

  • REGION: la región en la que se encuentra tu plantilla de entorno de ejecución
  • PROJECT_ID: ID del proyecto
  • NOTEBOOK_RUNTIME_TEMPLATE_ID: el ID de tu plantilla de entorno de ejecución
  • RELEASE_NAME: 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 configurar 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.

Versiones de Python compatibles

Colab Enterprise admite versiones de Python durante períodos específicos.

En la siguiente tabla, se muestran la fecha de finalización del parche y la compatibilidad y la fecha de disponibilidad para cada versión compatible de Python. Para obtener más información sobre estas fechas, consulta Comprende las fechas de finalización de la compatibilidad.

Versión de Python Fecha de finalización del parche y la compatibilidad Fecha de finalización de la disponibilidad
Python 3.12 Sin establecer Sin establecer
Python 3.11 Sin establecer Sin establecer
Python 3.10 23 de febrero de 2026 17 de agosto de 2026

Comprende las fechas de finalización de la compatibilidad

La compatibilidad con una versión de Python finaliza según las siguientes fechas:

  • Fecha de finalización del parche y la compatibilidad: Después de esta fecha, se producen los siguientes cambios

    • No puedes crear plantillas de entorno de ejecución que usen esta versión de Python.
    • Cualquiera de tus plantillas de entorno de ejecución existentes que usen esta versión de Python se actualizarán automáticamente para usar la versión más reciente de Python disponible.
    • Los entornos de ejecución existentes ya no se pueden actualizar.
    • Los entornos de ejecución dejan de funcionar seis meses después de su actualización más reciente o, si no se actualizan, seis meses después de su creación.

    Para solicitar una extensión para usar esta versión de Python hasta la fecha de disponibilidad, comunícate con tu Google Cloudrepresentante de cuenta.

  • Fecha de finalización de la disponibilidad: Después de esta fecha, se producen los siguientes cambios tienen lugar:

    • Esta versión de Python no está disponible en Colab Enterprise, incluso para los usuarios a los que se les otorgó una extensión.
    • Cualquier plantilla de entorno de ejecución existente que use esta versión de Python se actualizará automáticamente para usar la versión más reciente de Python disponible.

Los entornos de ejecución son regionales

Los entornos de ejecución son regionales y deben ubicarse en la misma región que tu notebook.

Los entornos de ejecución son exclusivos para un usuario

Los entornos de ejecución son exclusivos para un usuario. No puedes compartir tus entornos de ejecución con otras personas ni usar los suyos. Incluso si compartes un notebook con alguien, 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 entornos de ejecución basados en la misma plantilla de entorno 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 el entorno de ejecución, se borran todos los archivos que subes. Si modificaste archivos, esos archivos volverán a su estado original cuando se cree un entorno de ejecución nuevo. Consulta el período de eliminación automática en la sección Especificaciones de entorno de ejecución predeterminado.

Los notebooks pueden compartir entornos de ejecución

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

  • Es posible que los notebooks se ejecuten con lentitud porque comparten los recursos de procesamiento del entorno 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 versión cuando ejecutes el segundo notebook.

En lugar de ejecutar código desde 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 Puedes crear varios entornos de ejecución a partir de la misma plantilla de entorno de ejecución.

Cargos del entorno de ejecución

Se te cobra por el procesamiento del entorno de ejecución según el tipo de máquina y los aceleradores que usas. 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 entornos 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 de entorno de ejecución. El disco de arranque no se puede configurar.

Mientras los entornos de ejecución están apagados, 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 el disco de datos.

Para obtener más información, consulta 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 que no sea 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 entorno de ejecución.

Las plantillas de entorno de ejecución son regionales

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

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

Puedes compartir una plantilla de entorno 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 elementos:

Región

Elige la región en la que se encuentra tu notebook. Los entornos de ejecución creados a partir de plantillas de entorno de ejecución están en la misma región que la plantilla de entorno de ejecución. Para que el notebook ejecute código en el entorno de ejecución, el notebook y el entorno de ejecución deben estar en la misma región.

Tipo de máquina

Puedes configurar el tipo de máquina de tu plantilla de entorno de ejecución. Para obtener información sobre los tipos de máquina, consulta la guía de comparaciones 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 de entorno de ejecución.

Cuando se crea el entorno de ejecución, también 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 tu plantilla de 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 predeterminada de nube privada virtual del proyecto.

Cierre inactivo

Colab Enterprise habilita el cierre inactivo 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 a Internet pública

Para obtener 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 de 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 ADC para ejecutar código en tu notebook que interactúe con Agent Platform y otros Google Cloud servicios. Cuando se habilitan las credenciales de usuario final, tu notebook usa las credenciales de quien ejecuta el notebook para determinar el acceso a Google Cloud los recursos.

Si las credenciales de usuario final no están habilitadas, puedes obtener acceso 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 de usuario" de Configura ADC para un entorno de desarrollo local.

Cargos de la plantilla de entorno de ejecución

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

¿Qué sigue?