Ambiente de execução do Java

A função do Cloud Run é executada em um ambiente que consiste em uma versão do sistema operacional, além de pacotes complementares, suporte a linguagens e a biblioteca do Java Functions Framework que dá suporte e invoca a função. Esse ambiente é identificado pela versão da linguagem e é conhecido como ID do ambiente de execução.

Preparação de funções

É possível preparar uma função diretamente do Google Cloud console ou gravá-la na máquina local e fazer upload dela. Para preparar a máquina local para desenvolvimento do Java, consulte Configurar um ambiente de desenvolvimento do Java.

Ambientes de execução e imagens de base do Java compatíveis

Ambiente de execução ID do ambiente de execução Pilhas Imagem de base do ambiente de execução Descontinuação Desativar
Java 25 java25
  • google-24 (padrão)
  • google-24-full
    		•
  • google-24/java25
  • google-24-full/java25
    		•  Outubro de 2031
    Java 21 java21
  • google-22 (padrão)
  • google-22-full
    		•
  • google-22/java21
  • google-22-full/java21
    		•  Setembro de 2031
    Java 17 java17
  • google-22 (padrão)
  • google-22-full
    		•
  • google-22/java17
  • google-22-full/java17
    		•  Outubro de 2027
    Java 11 java11 google-18-full google-18-full/java11 2024-10-31 2025-10-31

    Selecionar o ambiente de execução

    É possível selecionar um dos ambientes de execução do Java compatíveis para a função durante a implantação.

    É possível selecionar uma versão do ambiente de execução usando o Google Cloud console ou a CLI gcloud. Clique na guia para ver instruções sobre como usar a ferramenta de sua preferência:

    gcloud

    Especifique a imagem de base do Java para a função usando a flag --base-image, ao implantá-la. Exemplo:

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

    Substitua:

    • FUNCTION pelo nome da função que você está implantando. É possível omitir esse parâmetro inteiramente, mas será solicitado o nome, se você omiti-lo.

    • FUNCTION_ENTRYPOINT: o ponto de entrada da função no código-fonte. Esse é o código que o Cloud Run executa quando é executada. O valor dessa flag precisa ser um nome de função ou de classe totalmente qualificada no código-fonte.

    Para instruções detalhadas sobre como implantar uma função usando a CLI gcloud, consulte Implantar funções no Cloud Run.

    Console

    É possível selecionar uma versão do ambiente de execução ao criar ou atualizar uma função do Cloud Run no Google Cloud console. Para instruções detalhadas sobre como implantar uma função, consulte Implantar funções no Cloud Run.

    Para selecionar um ambiente de execução no Google Cloud console ao criar uma função, siga estas etapas:

    1. No Google Cloud console, acesse a página do Cloud Run:

      Acessar o Cloud Run

    2. Clique em Escrever uma função.

    3. Na lista Ambiente de execução, selecione uma versão do ambiente de execução do Java.

    4. Clique em Criar e aguarde o Cloud Run criar o serviço usando uma revisão do marcador de posição.

    5. O console vai redirecionar você para a guia Origem, em que você pode ver o código-fonte da sua função. Clique em Salvar e implantar novamente.

    Para instruções detalhadas sobre como atualizar a versão do ambiente de execução depois que a função for implantada, consulte Reimplantar um novo código-fonte.

    Estrutura do código-fonte

    Para que as funções do Cloud Run encontrem a definição da sua função, seu código-fonte precisa seguir uma estrutura específica. Consulte Escrever funções do Cloud Run para mais informações.

    Como especificar dependências

    É possível especificar dependências para a função usando Maven ou Gradle. Para mais informações, consulte Especificar dependências em Java.

    Variáveis de ambiente

    O ambiente de execução do Java define automaticamente certas variáveis de ambiente para que sua função use conforme necessário. Para mais detalhes, consulte Configurar variáveis de ambiente.

    ID de execução

    Para funções Java que usam a versão 1.4.0 ou mais recente do functions-framework, é possível usar a classe de registro java.util.logging.Logger para adicionar um ID de execução exclusivo às saídas de registro. O uso de stdout ou stderr (por exemplo, System.println()) não adiciona o ID de execução.

    Observação:

    • Se você criou a função usando a API Cloud Functions v2 (por exemplo, usando gcloud functions, a API REST ou o Terraform), esse ID de execução será adicionado automaticamente.

    • Se você criou a função usando a API Cloud Run Admin (por exemplo, usandoconsole, Google Cloud , a API REST ou Terraform), será necessário definir a variável de ambiente LOG_EXECUTION_ID como true para usar esse recurso.gcloud run