El entorno de ejecución de Python

Tu función de Cloud Run se ejecuta en un entorno que consta de una versión del sistema operativo con paquetes de complementos, compatibilidad con lenguajes y la biblioteca de Functions Framework para Python que admite y, además, invoca la función. Este entorno se identifica con la versión del lenguaje y se conoce como el ID del entorno de ejecución.

Prepara funciones

Puedes preparar una función directamente desde la consola de Google Cloud o escribirla en tu máquina local y subirla. Si deseas preparar tu máquina local para el desarrollo de Python, consulta Configura un entorno de desarrollo de Python.

Entornos de ejecución de Python e imágenes base compatibles

Entorno de ejecución ID de entorno de ejecución Pilas Imagen base del entorno de ejecución Baja Desmantela
Python 3.15
(versión preliminar)		 python315
  • google-24 (predeterminada)
  • google-24-full
    		•
  • google-24/python315
  • google-24-full/python315
    		•
    Python 3.14 python314
  • google-24 (predeterminada)
  • google-24-full
    		•
  • google-24/python314
  • google-24-full/python314
    		•  2030-10-10 2031-04-10
    Python 3.13 python313
  • google-22 (predeterminada)
  • google-22-full
    		•
  • google-22/python313
  • google-22-full/python313
    		•  10-10-2029 10-4-2030
    Python 3.12 python312
  • google-22 (predeterminada)
  • google-22-full
    		•
  • google-22/python312
  • google-22-full/python312
    		•  02-10-2028 2-4-2029
    Python 3.11 python311
  • google-22 (predeterminada)
  • google-22-full
    		•
  • google-22/python311
  • google-22-full/python311
    		•  2027-10-24 24-4-2028
    Python 3.10 python310
  • google-22 (predeterminada)
  • google-22-full
    		•
  • google-22/python310
  • google-22-full/python310
    		•  2026-10-04 4-4-2027
    Python 3.9 python39 google-18-full google-18-full/python39 2025-10-05 5-4-2026
    Python 3.8 python38 google-18-full google-18-full/python38 14-10-2024 14-10-2025
    Python 3.7 python37 google-18-full google-18-full/python37 2024-01-30 2025-01-30

    Selecciona tu entorno de ejecución

    Puedes seleccionar uno de los entornos de ejecución de Python compatibles para tu función durante la implementación.

    Puedes seleccionar una versión del entorno de ejecución con la consola de Google Cloud o la gcloud CLI. Haz clic en la pestaña para obtener instrucciones de la herramienta que elijas:

    gcloud

    Especifica la imagen base de Python para tu función con la marca --base-image mientras implementas la función. Por ejemplo:

    gcloud run deploy FUNCTION \
    --source . \
    --function FUNCTION_ENTRYPOINT \
    --base-image python314

    Reemplaza lo siguiente:

    • FUNCTION por el nombre de la función que implementarás. Puedes omitir este parámetro por completo, pero se te solicitará el nombre si lo haces.

    • FUNCTION_ENTRYPOINT por el punto de entrada a tu función en tu código fuente. Este es el código que Cloud Run ejecuta cuando se ejecuta tu función. El valor de esta marca debe ser un nombre de función o un nombre de clase completamente calificado que exista en tu código fuente.

    Para obtener instrucciones detalladas sobre cómo implementar una función con gcloud CLI, consulta Implementa funciones en Cloud Run.

    Console

    Puedes seleccionar una versión del entorno de ejecución cuando crees o actualices una función de Cloud Run en la consola de Google Cloud . Para obtener instrucciones detalladas sobre cómo implementar una función, consulta Implementa funciones en Cloud Run.

    Para seleccionar un entorno de ejecución en la consola de Google Cloud cuando creas una función, sigue estos pasos:

    1. En la consola de Google Cloud , ve a la página de Cloud Run:

      Ir a Cloud Run

    2. Haz clic en Escribe una función.

    3. En la lista Entorno de ejecución, selecciona una versión del entorno de ejecución de Python.

    4. Haz clic en Crear y espera a que Cloud Run cree el servicio con una revisión de marcador de posición.

    5. La consola te redireccionará a la pestaña Fuente, en la que puedes ver el código fuente de tu función. Haz clic en Guardar y volver a implementar.

    Para obtener instrucciones detalladas sobre cómo actualizar la versión del entorno de ejecución después de implementar la función, consulta Vuelve a implementar el código fuente nuevo.

    Estructura del código fuente

    Para que Cloud Run Functions encuentre la definición de tu función, tu código fuente debe seguir una estructura específica. Consulta Escribe funciones de Cloud Run para obtener más información.

    Especifica las dependencias

    Existen varias formas de especificar las dependencias para las funciones de Cloud Run en Python: usa el archivo requirements.txt de un administrador de paquetes, configura un archivo pyproject.toml como el archivo de definición de proyecto estándar o empaqueta las dependencias locales junto con tu función. Para obtener más información, consulta Especifica dependencias en Python.

    Cloud Run Functions no admite la especificación de dependencias con Pipfile/Pipfile.lock, por lo que tu proyecto no debe incluir estos archivos.

    Variables de entorno

    El entorno de ejecución de Python configura de forma automática ciertas variables de entorno para que tu función las use según sea necesario. Para obtener más detalles, consulta Configura las variables de entorno.