Runtime di Python

Panoramica

La funzione Cloud Run viene eseguita in un ambiente costituito da una versione del sistema operativo, oltre a pacchetti aggiuntivi, supporto per le lingue e la libreria Functions Framework che supporta e richiama la funzione. Questo ambiente è identificato dalla versione in lingua ed è noto come runtime.

Per informazioni sui runtime in generale e per scoprire quale versione di Ubuntu viene utilizzata da ciascun runtime Python, consulta l'ambiente di esecuzione delle funzioni Cloud Run.

Per iniziare a utilizzare Python nelle funzioni Cloud Run, consulta la guida introduttiva.

Seleziona il runtime

Le funzioni Cloud Run supportano diverse versioni di Python, elencate nella pagina Supporto del runtime. Puoi seleziona il runtime Python preferito per la tua funzione durante il deployment.

gcloud

Se utilizzi Google Cloud CLI, specifica il runtime usando il parametro --runtime. Ad esempio:

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

FLAGS... si riferisce agli argomenti passati durante il primo del deployment della funzione. Per ulteriori informazioni sui argomenti facoltativi, vedi Esegui il deployment utilizzando Google Cloud CLI.

Console

Se utilizzi la console Google Cloud, consulta le Guida rapida della console Google Cloud per istruzioni dettagliate.

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.

Per iniziare rapidamente a utilizzare Python nelle funzioni Cloud Run, consulta la guida rapida.

Struttura del codice sorgente

Affinché le funzioni Cloud Run trovino la definizione della tua funzione, è necessario 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 scritte in Python: usando il file requirements.txt del gestore di pacchetti pip oppure pacchettizzare le dipendenze locali insieme alla tua funzione. Per ulteriori informazioni, vedi Specificare le dipendenze in Python.

Le funzioni Cloud Run non supportano la specifica delle dipendenze con Pipfile/Pipfile.lock. 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 Utilizzare le variabili di ambiente.