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

En esta página se describen los tiempos de ejecución y las plantillas de tiempo de ejecución de Colab Enterprise.

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

Una plantilla de tiempo de ejecución es una configuración de VM que especifica un tipo de máquina y otras características de la VM, así como ajustes comunes, como la red y si el acceso a Internet público está habilitado. Cuando creas un tiempo de ejecución, su VM se crea de acuerdo con las especificaciones de una plantilla de tiempo de ejecución.

Flujo de trabajo

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

Para configurar un tiempo de ejecución para necesidades específicas, debes hacer lo siguiente:

1. Crea una plantilla de tiempo de ejecución con la configuración que necesites.

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

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

Tiempos de ejecución

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

Tiempo 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 tiempo de ejecución predeterminado sin aceleradores o cambiar a un tiempo de ejecución predeterminado que incluya aceleradores.

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

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 tiempo de ejecución predeterminadas

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

Versiones de Python

Desde mayo del 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.11). Esto significa que, cuando haya una nueva versión de Python disponible en Colab Enterprise, los nuevos tiempos de ejecución creados a partir de la plantilla de tiempo de ejecución predeterminada usarán la versión de Python más reciente.

Si tus plantillas de tiempo de ejecución predeterminadas se crearon en mayo del 2025 o antes, es posible que estén configuradas para usar Python 3.10. Para actualizar una plantilla de tiempo de ejecución predeterminada y usar la versión más reciente de Python, debes eliminarla. Después, cuando se cree una nueva plantilla de tiempo 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 hayas creado, consulta 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 no cambia automáticamente, aunque haya una nueva versión de Python disponible en Colab Enterprise. No se puede cambiar la versión de Python de un entorno de ejecución. En su lugar, debes crear un nuevo tiempo de ejecución derivado de una plantilla de tiempo de ejecución que use la versión de Python que quieras.

Cambiar la versión de Python de una plantilla de tiempo de ejecución

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

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

• REGION: la región en la que se encuentra tu plantilla de tiempo de ejecución.
• PROJECT_ID: tu ID de 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 quieras usar. Por ejemplo, py311 es el nombre de la versión de la imagen de Python 3.11. Para definir la imagen como 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 -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"

$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

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

Los entornos de ejecución son regionales

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

Los tiempos de ejecución son exclusivos de un usuario

Los tiempos de ejecución son exclusivos de un usuario. No puedes compartir tus tiempos de ejecución con otros usuarios ni usar los suyos. Aunque compartas un cuaderno con alguien, esa persona no tendrá acceso a tu tiempo de ejecución y deberá ejecutar el cuaderno en su propio tiempo de ejecución.

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

Gestionar los archivos de tu tiempo de ejecución

Para acceder a los archivos de tu entorno de ejecución y modificarlos, usa el botón  Archivos de Colab Enterprise. También puedes subir archivos a tu tiempo de ejecución.

Cuando se elimina tu entorno de ejecución, se eliminan todos los archivos que subas. Si has modificado archivos, estos volverán a su estado original cuando se cree un nuevo tiempo de ejecución. Consulta el periodo de eliminación automática en la sección Especificaciones predeterminadas del tiempo de ejecución.

Los tiempos de ejecución se pueden compartir entre cuadernos

Puedes conectar más de un cuaderno al mismo tiempo de ejecución, pero no es recomendable. Si varios cuadernos comparten el mismo tiempo de ejecución, pueden surgir problemas, como los siguientes:

• Es posible que los cuadernos se ejecuten lentamente porque comparten los recursos de computación del tiempo de ejecución.

• El código de un cuaderno puede afectar al estado de la VM del tiempo de ejecución del otro cuaderno. Por ejemplo, si instalas la versión 1.3 de un paquete en un cuaderno, pero tu otro cuaderno requiere la versión 1.2, es posible que tengas un problema de incompatibilidad de versiones al ejecutar el segundo cuaderno.

En lugar de ejecutar código de varios cuadernos en el mismo tiempo de ejecución, puedes crear un tiempo de ejecución para cada cuaderno a partir de la misma plantilla de tiempo de ejecución. Consulta Puedes crear varios tiempos de ejecución a partir de la misma plantilla de tiempo de ejecución.

Cargos de tiempo de ejecución

Se te cobra por el procesamiento del tiempo de ejecución en función del tipo de máquina y los aceleradores que utilices. También se te cobrará por el almacenamiento de discos de arranque y de datos. Los discos de arranque y los discos de datos se eliminan cuando se eliminan los tiempos de ejecución.

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

Mientras los tiempos de ejecución están cerrados:

• No se generan cargos de computación porque no se usa la CPU ni la GPU.
• Se cobra el almacenamiento en el disco de arranque y en el disco de datos.

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

Puedes crear varios tiempos de ejecución a partir de la misma plantilla de tiempo de ejecución

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

Las plantillas de entorno 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 tiempo de ejecución son regionales. Cuando creas un tiempo de ejecución, se encuentra en la misma región que la plantilla de tiempo de ejecución y solo se puede usar con cuadernos de 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 forma, cada usuario puede crear su propio tiempo de ejecución a partir de la misma plantilla de tiempo de ejecución y, por lo tanto, varios usuarios pueden ejecutar el mismo cuaderno en la misma configuración de máquina virtual.

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

Configuración

Las plantillas de tiempo de ejecución determinan la configuración de la máquina virtual de tu tiempo de ejecución. Puedes especificar cualquiera de las siguientes opciones:

Región

Elige la región en la que se encuentra tu cuaderno. Los tiempos de ejecución creados a partir de plantillas de tiempo de ejecución están en la misma región que la plantilla de tiempo de ejecución. Para que el cuaderno ejecute código en el tiempo de ejecución, el cuaderno y el tiempo 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 tiempo de ejecución. Para obtener información sobre los tipos de máquinas, consulta la guía de comparación y recursos de las familias de máquinas.

Disco de datos

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

Cuando se crea tu tiempo 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 añadir aceleradores a la configuración de tu plantilla de tiempo de ejecución. La disponibilidad de los aceleradores depende del tipo de máquina y de la región.

Red

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

Apagado por inactividad

Colab Enterprise habilita el cierre por inactividad de forma predeterminada. Este ajuste apaga tu instancia tras 180 minutos de inactividad. Puedes cambiar el número de minutos de inactividad antes de que se apague o inhabilitar el apagado por inactividad.

Acceso público a Internet

Para tener más control sobre la seguridad de tu cuaderno y otros recursos, puedes desactivar el acceso público a Internet. Si configuras tu plantilla de tiempo de ejecución de esta forma, los cuadernos que usen tiempos de ejecución creados a partir de la plantilla de tiempo de ejecución no tendrán acceso a Internet público.

Autenticación de credenciales de usuario final

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

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

Cargos por plantillas de tiempo de ejecución

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

Siguientes pasos

• Crea un tiempo de ejecución a partir de una plantilla de tiempo de ejecución.
• Conéctate a un entorno de ejecución.
• Crea una plantilla de tiempo de ejecución.