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 complementarios, compatibilidad con idiomas y la biblioteca Java Functions Framework, que admite e invoca tu función. Este entorno se identifica por la versión del idioma y se conoce como ID de tiempo de ejecución.

Preparación de la función

Puedes preparar una función directamente desde la Google Cloud consola o escribirla en tu máquina local y subirla. Para preparar tu máquina local para el desarrollo de Java, consulta el artículo Configurar un entorno de desarrollo de Java.

Runtimes e imágenes base de Java admitidos

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

    Selecciona tu tiempo de ejecución

    Puedes seleccionar uno de los tiempos de ejecución de Java admitidos para tu función durante la implementación.

    Puedes seleccionar una versión del tiempo de ejecución mediante la Google Cloud consola o la CLI de gcloud. Haga clic en la pestaña para ver las instrucciones sobre cómo usar la herramienta que elija:

    gcloud

    Especifica la imagen base de Java de tu función con la marca --base-image al desplegarla. Por ejemplo:

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

    Sustituye:

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

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

    Para obtener instrucciones detalladas sobre cómo desplegar una función con la CLI de gcloud, consulta Desplegar funciones en Cloud Run.

    Consola

    Puedes seleccionar una versión del tiempo de ejecución al crear o actualizar una función de Cloud Run en la Google Cloud consola. Para obtener instrucciones detalladas sobre cómo desplegar una función, consulta Desplegar funciones en Cloud Run.

    Para seleccionar un tiempo de ejecución en la consola Google Cloud al crear una función, sigue estos pasos:

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

      Ir a Cloud Run

    2. Haz clic en Escribir una función.

    3. En la lista Runtime (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 redirigirá a la pestaña Fuente, donde podrás 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 tiempo de ejecución después de implementar la función, consulta Volver a implementar código fuente nuevo.

    Estructura del código fuente

    Para que las funciones de Cloud Run encuentren la definición de tu función, el código fuente debe seguir una estructura específica. Para obtener más información, consulta Escribir funciones de Cloud Run.

    Especificar dependencias

    Puedes especificar las dependencias de tu función con Maven o Gradle. Para obtener más información, consulta Especificar dependencias en Java.

    Variables de entorno

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

    ID de ejecución

    En el caso de las funciones de Java que usen la versión 1.4.0 o posterior de functions-framework, puedes usar la clase de registro java.util.logging.Logger para añadir un ID de ejecución único a los resultados del registro. Si usas stdout o stderr (por ejemplo, System.println()), no se añade el ID de ejecución.

    Ten en cuenta que:

    • Si has creado la función con la API Cloud Functions v2 (por ejemplo, con gcloud functions, la API REST o Terraform), este ID de ejecución se añade automáticamente.

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