Tempo de execução do Python

Visão geral

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 Functions Framework que dá suporte e invoca a função. Esse ambiente é identificado pela versão da linguagem e conhecido como ambiente de execução.

Para mais informações sobre tempos de execução em geral e para saber qual versão do Ubuntu cada ambiente de execução Python usa, consulte o ambiente de execução do Cloud Run functions.

Para começar a usar o Python nas funções do Cloud Run, consulte o Guia de início rápido.

Selecionar o ambiente de execução

As funções do Cloud Run dão suporte a várias versões do Python, que estão listadas na página Suporte ao ambiente de execução. Selecione seu ambiente de execução Python preferencial para a função durante a implantação.

gcloud

Se você estiver usando a Google Cloud CLI, especifique o ambiente de execução usando o parâmetro --runtime. Exemplo:

gcloud functions deploy NAME --runtime python312 --trigger-http FLAGS...

FLAGS... refere-se a argumentos transmitidos durante a primeira implantação da função. Para mais informações sobre argumentos obrigatórios e opcionais, consulte Implantação com a CLI do Google Cloud.

Console

Se você estiver usando o console do Google Cloud, consulte o Guia de início rápido do console do Google Cloud para conferir instruções detalhadas.

Preparação de funções

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

Para começar rapidamente a usar o Python no Cloud Run functions, consulte o Guia de início rápido.

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 Como escrever funções do Cloud Run para mais informações.

Como especificar dependências

Há duas maneiras de especificar dependências para o Cloud Run functions escritas em Python: usando o arquivo requirements.txt do gerenciador de pacotes pip ou o empacotamento de dependências locais junto com sua função. Para mais informações, consulte Como identificar dependências em Python.

O Cloud Run functions não dá suporte à especificação de dependências com Pipfile/Pipfile.lock. Seu projeto não deve incluir esses arquivos.

Variáveis de ambiente

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