El entorno de ejecución de Java

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 Java Functions Framework que admite e invoca la función. Este entorno se identifica mediante la versión del lenguaje y se conoce como el ID del entorno de ejecución.

Preparación de 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 en Java, consulta Configura un entorno de desarrollo de Java.

Entornos de ejecución y imágenes base de Java compatibles

Entorno de ejecución ID de entorno de ejecución Pilas Imagen base del entorno de ejecución
Java 21 java21
  • google-22 (predeterminada)
  • google-22-full
    		•
  • google-22/java21
  • google-22-full/java21
    		•
    Java 17 java17
  • google-22 (predeterminada)
  • google-22-full
    		•
  • google-22/java17
  • google-22-full/java17
    		•
    Java 11 java11 google-18-full google-18-full/java11

    Selecciona tu entorno de ejecución

    Puedes seleccionar uno de los entornos de ejecución de Java 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 gcloud CLI. Haz clic en la pestaña para obtener instrucciones sobre el uso de la herramienta que elijas:

    gcloud

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

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

    Reemplaza lo siguiente:

    • Reemplaza FUNCTION por el nombre de la función que implementas. 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 creas o actualizas una función de Cloud Run en la consola de Google Cloud . Si deseas obtener instrucciones detalladas para implementar una función, consulta Implementa funciones en Cloud Run.

    Para seleccionar un entorno de ejecución en la Google Cloud consola 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 Java.

    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.

    Si deseas obtener instrucciones detalladas para actualizar la versión del entorno de ejecución después de implementar la función, consulta Cómo volver a implementar un 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 dependencias

    Puedes especificar dependencias para la función mediante Maven o Gradle. Para obtener más información, consulta Especifica dependencias en Java.

    Variables de entorno

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

    ID de ejecución

    En el caso de las funciones de Java que usan functions-framework versión 1.4.0 o posterior, puedes usar la clase de registro java.util.logging.Logger para agregar un ID de ejecución único a los resultados de registro. El uso de stdout o stderr (por ejemplo, System.println()) no agrega el ID de ejecución.

    Ten en cuenta lo siguiente:

    • Si creaste tu función con la API de Cloud Functions v2 (por ejemplo, con gcloud functions, la API de REST o Terraform), este ID de ejecución se agrega automáticamente.

    • Si creaste tu función con la API de Cloud Run Admin (por ejemplo, con Google Cloud console, gcloud run, la API de REST o Terraform), debes configurar la variable de entorno LOG_EXECUTION_ID en true para usar esta función.