La funzione Cloud Run viene eseguita in un ambiente costituito da una versione del sistema operativo con pacchetti aggiuntivi, supporto per le lingue e la libreria Python Functions Framework che supporta e richiama la funzione. Questo ambiente viene identificato dalla versione della lingua ed è noto come ID runtime.
Preparazione della funzione
Puoi preparare una funzione direttamente dalla console Google Cloud o scriverla sulla tua macchina locale e caricarla. Per preparare la tua macchina locale per lo sviluppo in Python, consulta Configurare un ambiente di sviluppo Python.
Runtime e immagini di base Python supportati
| Runtime | ID runtime | Serie | Immagine di base del runtime |
|---|---|---|---|
| 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 |
Seleziona il runtime
Puoi selezionare uno dei runtime Python supportati per la tua funzione durante il deployment.
Puoi selezionare una versione di runtime utilizzando la console Google Cloud o la riga di comando gcloud. Fai clic sulla scheda per leggere le istruzioni sull'utilizzo dello strumento scelto:
gcloud
Specifica l'immagine di base Python per la tua funzione utilizzando il flag --base-image,
durante il deployment della funzione. Ad esempio:
gcloud beta run deploy FUNCTION \
--source . \
--function FUNCTION_ENTRYPOINT \
--base-image python312
Sostituisci:
FUNCTION con il nome della funzione di cui stai eseguendo il deployment. Puoi omettere del tutto questo parametro, ma se lo fai ti verrà chiesto il nome.
FUNCTION_ENTRYPOINT con il punto di ingresso 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 completamente qualificato esistente nel codice sorgente.
Per istruzioni dettagliate sul deployment di una funzione utilizzando l'interfaccia a riga di comando gcloud, consulta Eseguire il deployment di 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 Eseguire il deployment di funzioni in Cloud Run.
Per selezionare un runtime nella console Google Cloud quando crei una funzione:
Nella console Google Cloud, vai alla pagina Cloud Run:
Fai clic su Scrivi una funzione.
Nell'elenco Runtime, seleziona una versione del runtime di 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 ridistribuisci.
Per istruzioni dettagliate su come aggiornare la versione del runtime dopo il deployment della funzione, consulta Eseguire nuovamente il deployment del nuovo codice sorgente.
Struttura del codice sorgente
Affinché le funzioni Cloud Run trovino la definizione della funzione, il codice sorgente deve seguire una struttura specifica. Per ulteriori informazioni, consulta Scrivere funzioni Cloud Run.
Specifica delle dipendenze
Esistono due modi per specificare le dipendenze per le funzioni Cloud Run escritas in Python: utilizzando il file requirements.txt del gestore dei pacchetti pip o impacchettando le dipendenze locali insieme alla funzione. Per ulteriori informazioni, consulta
Specificare le dipendenze in Python.
Le funzioni Cloud Run non supportano la specifica delle dipendenze con Pipfile/Pipfile.lock, pertanto il progetto non deve includere questi file.
Variabili di ambiente
Il runtime di Python imposta automaticamente determinate variabili di ambiente per la funzione da utilizzare in base alle esigenze. Per maggiori dettagli, vedi Configurare le variabili di ambiente.