Tempo de execução do Python

Informações gerais

A Função do Cloud é 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 é compatível 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 Functions.

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

Selecionar o ambiente de execução

O Cloud Functions dá 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

Para mais parâmetros de implantação, 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 Functions, consulte o Guia de início rápido.

Estrutura do código-fonte

Para que o Cloud Functions encontre a definição da sua função, seu código-fonte precisa seguir uma estrutura específica. Consulte Como escrever Cloud Functions para conferir mais informações.

Como especificar dependências

Há duas maneiras de especificar dependências para o Cloud 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 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.