La tua funzione Cloud Run viene eseguita in un ambiente costituito da una versione del sistema operativo con componenti aggiuntivi, supporto dei linguaggi e la libreria del framework di Functions per Python che supporta e richiama la tua funzione. Questo ambiente è identificato dalla versione del linguaggio ed è noto come ID runtime.
Preparazione della funzione
Puoi preparare una funzione direttamente dalla console Google Cloud , oppure puoi scriverla sulla tua macchina locale e caricarla. Per preparare la tua macchina locale per lo sviluppo Python, consulta Configura un ambiente di sviluppo Python.
Runtime Python e immagini di base supportati
| Runtime | ID runtime | Stack | Immagine di base runtime | Ritiro | Dismissione |
|---|---|---|---|---|---|
| Python 3.15 (anteprima) |
python315 |
|
|
||
| Python 3.14 | python314 |
|
|
2030-10-10 | 2031-04-10 |
| Python 3.13 | python313 |
|
|
10/10/2029 | 10/04/2030 |
| Python 3.12 | python312 |
|
|
10/02/2028 | 02/04/2029 |
| Python 3.11 | python311 |
|
|
24/10/2027 | 24/04/2028 |
| Python 3.10 | python310 |
|
|
4/10/2026 | 04/04/2027 |
| Python 3.9 | python39 | google-18-full | google-18-full/python39 | 5/10/2025 | 05/04/2026 |
| Python 3.8 | python38 | google-18-full | google-18-full/python38 | 14/10/2024 | 14/10/2025 |
| Python 3.7 | python37 | google-18-full | google-18-full/python37 | 30/01/2024 | 30/01/2025 |
Seleziona il runtime
Puoi selezionare uno dei runtime Python supportati per la tua funzione durante il deployment.
Puoi selezionare una versione runtime utilizzando la console Google Cloud o gcloud CLI. Fai clic sulla scheda per visualizzare le istruzioni sull'utilizzo dello strumento che preferisci:
gcloud
Specifica l'immagine di base Python per la tua funzione utilizzando il flag --base-image durante il deployment della funzione. Ad esempio:
gcloud run deploy FUNCTION \
--source . \
--function FUNCTION_ENTRYPOINT \
--base-image python314
Sostituisci:
FUNCTION con il nome della funzione di cui stai eseguendo il deployment. Puoi omettere completamente questo parametro, ma se lo ometti, ti verrà richiesto il nome.
FUNCTION_ENTRYPOINT con l'entry point della funzione nel codice sorgente. Questo è il codice che Cloud Run esegue quando viene eseguita la funzione. Il valore di questo flag deve essere un nome di funzione o un nome di classe completo esistente nel codice sorgente.
Per istruzioni dettagliate su come eseguire il deployment di una funzione utilizzando gcloud CLI, consulta Esegui il deployment delle funzioni in Cloud Run.
Console
Puoi selezionare una versione del runtime quando crei o aggiorni una funzione Cloud Run nella console Google Cloud . Per istruzioni dettagliate sul deployment di una funzione, consulta Esegui il deployment delle funzioni in Cloud Run.
Per selezionare un runtime nella console Google Cloud quando crei una funzione, segui questi passaggi:
Nella console Google Cloud , vai alla pagina Cloud Run:
Fai clic su Scrivi una funzione.
Nell'elenco Runtime, seleziona una versione di runtime Python.
Fai clic su Crea e attendi che Cloud Run crei il servizio utilizzando una revisione segnaposto.
La console ti reindirizzerà alla scheda Origine, dove potrai visualizzare il codice sorgente della funzione. Fai clic su Salva e riesegui il deployment.
Per istruzioni dettagliate sull'aggiornamento della versione runtime dopo il deployment della funzione, consulta Esegui nuovamente il deployment del nuovo codice sorgente.
Struttura del codice sorgente
Affinché Cloud Run Functions trovi la definizione della tua funzione, il codice sorgente deve seguire una struttura specifica. Per saperne di più, consulta Scrivi funzioni Cloud Run.
Specifica le dipendenze
Esistono diversi modi per specificare le dipendenze per Cloud Run Functions in Python: utilizza il file requirements.txt di un gestore di pacchetti, configura un file pyproject.toml come file di definizione del progetto standard o pacchettizza le dipendenze locali insieme alla funzione. Per saperne di più, consulta Specifica delle dipendenze in Python.
Cloud Run Functions non supporta la specifica delle dipendenze con Pipfile/Pipfile.lock, pertanto il progetto non deve includere questi file.
Variabili di ambiente
Il runtime Python imposta automaticamente alcune variabili di ambiente che la tua funzione può utilizzare in base alle esigenze. Per maggiori dettagli, consulta Configura le variabili di ambiente.