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

Solo se permite un tiempo de ejecución predeterminado sin aceleradores y un tiempo de ejecución predeterminado con aceleradores para cada usuario por proyecto y por región.

Cuando Colab Enterprise crea un entorno de ejecución predeterminado, primero crea una plantilla de entorno de ejecución predeterminado correspondiente si el proyecto aún no tiene una en la región. Tanto el entorno de ejecución predeterminado como la plantilla de entorno 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 si no existe una plantilla de entorno de ejecución predeterminado, 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 si no existe una plantilla de entorno de ejecución predeterminado con aceleradores, por proyecto y por región.

Especificaciones de entorno de ejecución predeterminado

Los tiempos de ejecución predeterminados y sus correspondientes plantillas de tiempo de ejecución predeterminado creadas automáticamente incluyen las siguientes especificaciones:

Especificación Predeterminado Predeterminada 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

Cómo establecer una plantilla de entorno de ejecución como la predeterminada

Puedes establecer una plantilla de entorno de ejecución existente como la plantilla de entorno de ejecución predeterminada para tu proyecto y región. Cuando estableces una plantilla de entorno de ejecución como predeterminada, los nuevos entornos de ejecución predeterminados creados en el proyecto y la región actuales usan la configuración de esa plantilla. Los entornos de ejecución existentes no se verán afectados.

Después de que se establece una plantilla de entorno de ejecución como la predeterminada, todos los entornos de ejecución nuevos que se creen a partir de la plantilla de entorno de ejecución predeterminada se borrarán automáticamente 18 horas después de su creación.

Cada combinación de región y proyecto puede tener solo una plantilla de entorno de ejecución predeterminada sin aceleradores y una plantilla de entorno de ejecución predeterminada con aceleradores. Las plantillas de entorno de ejecución que antes eran las predeterminadas se convierten en plantillas definidas por el usuario, y los nuevos entornos de ejecución creados a partir de ellas se borran automáticamente después de 6 meses.

Puedes establecer una plantilla de entorno de ejecución predeterminada sin aceleradores y una plantilla de entorno de ejecución predeterminada con aceleradores.

Para establecer una plantilla de entorno de ejecución como la plantilla predeterminada, puedes usar la consola deGoogle Cloud . Puedes hacerlo desde la página Plantillas de entorno de ejecución o desde la página de detalles de una plantilla de entorno de ejecución.

En la página de plantillas de entorno de ejecución, haz lo siguiente:

  1. En la consola de Google Cloud , 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 fila de la plantilla de tiempo de ejecución que deseas establecer como predeterminada, haz clic en  Acciones.

  4. Según si la plantilla incluye aceleradores, haz lo siguiente:

    • En el caso de una plantilla sin aceleradores, haz clic en Establecer como predeterminado.
    • Para una plantilla con aceleradores, haz clic en Establecer como Predeterminada con GPU.

  5. En el diálogo de confirmación, haz clic en Establecer como predeterminado o Establecer como predeterminado con GPU para confirmar.

En la página de detalles de la plantilla de entorno de ejecución, haz lo siguiente:

  1. En la consola de Google Cloud , 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 ID de la plantilla de tiempo de ejecución que deseas establecer como predeterminada.

  4. En la barra de acciones que se encuentra en la parte superior de la página, haz clic en  Establecer como predeterminado o  Establecer como predeterminado con GPU.

  5. En el diálogo de confirmación, haz clic en Establecer como predeterminado o Establecer como predeterminado con GPU para confirmar.

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 usar 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 predeterminado, 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 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 entorno de ejecución nuevo 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 de entorno de ejecución

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

Console

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

  1. En la consola de Google Cloud , 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 tiempo de ejecución que deseas editar.

  4. Haz clic en  Editar.

  5. En el panel Edit runtime template, realiza cambios en la plantilla del 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: 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.

Versiones de Python compatibles

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

En la siguiente tabla, se indican la fecha de finalización de parches y asistencia y la fecha de disponibilidad para cada versión compatible de Python. Para obtener más información sobre estas fechas, consulta Información sobre 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

Información sobre las fechas de finalización de la asistencia

La compatibilidad con una versión de Python finaliza en 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á automáticamente para usar la versión de Python disponible más reciente.
    • Ya no se pueden actualizar los tiempos de ejecución existentes.
    • Los tiempos 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 fin de disponibilidad, comunícate con tu Google Cloudrepresentante de cuenta.

  • Fecha de fin de la disponibilidad: Después de esta fecha, se producen los siguientes cambios:

    • Esta versión de Python no está disponible en Colab Enterprise, ni siquiera para los usuarios a los que se les otorgó una extensión.
    • Las plantillas de entorno de ejecución existentes que usan esta versión de Python se actualizan automáticamente para usar la versión de Python disponible más reciente.

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 cada 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 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 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 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 apagan los entornos 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 entorno de ejecución, este se encuentra en la misma región que la plantilla del entorno 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 a Internet público. 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 ADC para ejecutar código en tu notebook que interactúe con Agent Platform 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 de 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?