A função do Cloud Run é executada em um ambiente que consiste em uma versão do sistema operacional com pacotes complementares, suporte a linguagens e a biblioteca Python Functions Framework que dá suporte e invoca a função. Esse ambiente é identificado pela versão da linguagem e é conhecido como ID de execução.
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 em Python, consulte Configurar um ambiente de desenvolvimento do Python.
Ambientes de execução e imagens de base do Python com suporte
| Ambiente de execução | ID do ambiente de execução | Pilhas | Imagem de base do ambiente de execução |
|---|---|---|---|
| Python 3.12 | python312 |
|
|
| Python 3.11 | python311 |
|
|
| Python 3.10 | python310 |
|
|
| Python 3.9 | python39 | google-18-full | google-18-full/python39 |
| Python 3.8 | python38 | google-18-full | google-18-full/python38 |
| Python 3.7 | python37 | google-18-full | google-18-full/python37 |
Selecionar o ambiente de execução
Selecione um dos ambientes de execução do Python com suporte para a função durante a implantação.
É possível selecionar uma versão do ambiente de execução usando o console do Google Cloud ou a CLI gcloud. Clique na guia para conferir instruções sobre como usar a ferramenta de sua preferência:
gcloud
Especifique a imagem de base do Python para a função usando a flag --base-image ao implantar a função. Exemplo:
gcloud beta run deploy FUNCTION \
--source . \
--function FUNCTION_ENTRYPOINT \
--base-image python312
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 sinalização 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 console do Google Cloud. 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 console do Google Cloud ao criar uma função, siga estas etapas:
No console do Google Cloud, acesse a página do Cloud Run:
Clique em Escrever uma função.
Na lista Ambiente de execução, selecione uma versão do ambiente de execução do Python.
Clique em Criar e aguarde o Cloud Run criar o serviço usando uma revisão do marcador de posição.
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 o 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
Há duas maneiras de especificar dependências para funções do Cloud Run
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
Especificar dependências em Python.
O Cloud Run functions não dá suporte à especificação de dependências com
o Pipfile/Pipfile.lock. Portanto, 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 mais detalhes, consulte Configurar variáveis de ambiente.