Il runtime Python è lo stack software responsabile dell'installazione del codice e delle dipendenze del servizio web e dell'esecuzione del servizio App Engine.
Il runtime Python per App Engine nell'ambiente standard è dichiarato nel file app.yaml
:
runtime: pythonVERSION
Dove VERSION sono i numeri di versione Python di MAJOR
e MINOR
. Ad esempio, per utilizzare la versione Python più recente, Python 3.12, specifica 312
.
Per altre versioni di Python supportate e la versione Ubuntu corrispondente per la tua versione Python, fai riferimento alla pianificazione del supporto di runtime.
Versioni Python 3
Il runtime Python utilizza l'ultima release stabile della
versione specificata nel file app.yaml
.
App Engine si aggiorna automaticamente alle nuove versioni
delle patch, ma non aggiorna automaticamente la versione secondaria.
Ad esempio, è possibile che il deployment dell'applicazione sia stato eseguito in Python 3.7.0 e successivamente aggiornata automaticamente a Python 3.7.1, ma non verrà aggiornata automaticamente alla versione secondaria successiva, Python 3.8.0.
Provalo
Se non conosci Google Cloud, crea un account per valutare le prestazioni di App Engine in scenari reali. I nuovi clienti ricevono anche 300 $ di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
Prova App Engine gratuitamenteApp Engine esegue le app Python in un container protetto da gVisor su una distribuzione aggiornata di Ubuntu Linux.
Dipendenze
Durante il deployment, App Engine utilizza il gestore di pacchetti Python pip
per installare le dipendenze definite nel file di metadati requirements.txt
che si trova nella directory principale del progetto. Non è necessario caricare le dipendenze perché App Engine esegue una nuova installazione.
La specifica delle dipendenze mediante lo standard Pipfile
/Pipfile.lock
non è attualmente supportata e il progetto non deve avere questi file.
Avvio dell'applicazione
Il runtime avvia l'app eseguendo il comando specificato nel campo entrypoint
del tuo file app.yaml
. Se hai configurato un entry point del server web Gunicorn nel file app.yaml
, devi anche aggiungere gunicorn
al file requirements.txt
.
Il punto di ingresso deve avviare un server web in ascolto sulla porta specificata dalla variabile di ambiente PORT
. Ad esempio:
entrypoint: gunicorn -b :$PORT main:app
Il framework web utilizzato dalla tua app è responsabile dell'instradamento delle richieste ai gestori appropriati nell'app.
Se la tua app soddisfa i requisiti seguenti, App Engine avvierà l'app con il server web gunicorn
se non specifichi il campo entrypoint
:
La radice della directory dell'app contiene un file
main.py
con un oggetto compatibile con WSGI chiamatoapp
.L'app non contiene file
Pipfile
oPipfile.lock
.
Se non specifichi un punto di ingresso per il runtime Python 3, App Engine configura e avvia il server web Gunicorn predefinito.
Best practice per il punto di ingresso
Assicurati che il modulo Python necessario per eseguire il punto di ingresso specificato in
app.yaml
sia presente nel filerequirements.txt
. Aggiungigunicorn
al filerequirements.txt
solo se un endpointgunicorn
viene specificato esplicitamente nel fileapp.yaml
.Per ottenere prestazioni ottimali, il punto di ingresso deve essere leggero perché viene eseguito ogni volta che viene creata una nuova istanza dell'applicazione.
Puoi utilizzare il campo del punto di ingresso per ottimizzare le prestazioni della tua app. Ad esempio, se utilizzi
gunicorn
come server web, puoi utilizzare il flag--workers
nel campo del punto di ingresso per configurare il numero di worker che gestiscono la tua app.Il numero di worker specificato deve corrispondere alla classe istanza dell'app App Engine:
Classe di istanza Worker F1 2 F2 4 F4 8 F4_1G 8 B1 2 B2 4 B4 8 B4_1G 8 B8 8 Queste indicazioni fungono da punto di partenza per selezionare il numero di worker. Potresti dover utilizzare un numero diverso di worker a seconda delle caratteristiche prestazionali dell'app. L'esempio seguente mostra un deployment di App Engine che utilizza due worker
gunicorn
per la gestione delle app:entrypoint: gunicorn -b :$PORT -w 2 main:app
Ti consigliamo di configurare il server web per l'ascolto e la risposta alle richieste HTTP sulla porta specificata dalla variabile di ambiente
$PORT
. L'uso della porta predefinita8080
impedisce ad App Engine di utilizzare il proprio livello NGINX per comprimere le risposte HTTP. Tieni presente che se utilizzi la porta8080
, gli avvisi relativi alla porta8080
e NGINX verranno visualizzati nei file di log dell'app.
Altri framework web
Oltre a Django e Flask, puoi utilizzare altri framework web con
App Engine, ad esempio
uwsgi
e
Tornado
. L'esempio seguente mostra come utilizzare uwsgi
con App Engine:
Variabili di ambiente
Le seguenti variabili di ambiente sono impostate dal runtime:
Variabile di ambiente | Descrizione |
---|---|
GAE_APPLICATION
|
L'ID della tua applicazione App Engine. Questo ID è preceduto dal prefisso "region code~", ad esempio "e~" per le applicazioni di cui è stato eseguito il deployment in Europa. |
GAE_DEPLOYMENT_ID |
L'ID del deployment attuale. |
GAE_ENV |
L'ambiente App Engine. Impostata su standard . |
GAE_INSTANCE |
L'ID dell'istanza su cui è attualmente in esecuzione il servizio. |
GAE_MEMORY_MB |
La quantità di memoria disponibile per il processo di richiesta, in MB. |
GAE_RUNTIME |
Il tempo di esecuzione specificato nel file app.yaml . |
GAE_SERVICE |
Il nome del servizio specificato nel file app.yaml . Se non viene specificato alcun nome di servizio, viene impostato su default . |
GAE_VERSION |
L'etichetta della versione corrente del servizio. |
GOOGLE_CLOUD_PROJECT |
L'ID progetto Google Cloud associato alla tua applicazione. |
PORT |
La porta che riceve le richieste HTTP. |
NODE_ENV (disponibile solo nel runtime Node.js) |
Imposta su production quando viene eseguito il deployment del servizio. |
Puoi
definire variabili di ambiente aggiuntive nel file app.yaml
,
ma i valori precedenti non possono essere sostituiti, ad eccezione di NODE_ENV
.
Proxy HTTPS e di forwarding
App Engine termina le connessioni HTTPS a livello di bilanciatore del carico e inoltra le richieste all'applicazione. Alcune applicazioni devono determinare
l'IP e il protocollo della richiesta originale. L'indirizzo IP dell'utente è disponibile nell'intestazione X-Forwarded-For
standard. Le applicazioni che richiedono queste
informazioni devono configurare il proprio framework web per considerare attendibile il proxy.
File system
Il runtime include un file system completo. Il file system è di sola lettura, ad eccezione della posizione /tmp
, che è un disco virtuale in cui vengono archiviati i dati nella RAM dell'istanza di App Engine.
Server metadati
Ogni istanza dell'applicazione può utilizzare il server di metadati di App Engine per eseguire query sulle informazioni sull'istanza e sul progetto.
Puoi accedere al server di metadati tramite i seguenti endpoint:
http://metadata
http://metadata.google.internal
Le richieste inviate al server dei metadati devono includere l'intestazione della richiesta
Metadata-Flavor: Google
. Questa intestazione indica che la richiesta è stata inviata
con l'intento di recuperare i valori dei metadati.
La tabella seguente elenca gli endpoint in cui è possibile effettuare richieste HTTP per metadati specifici:
Endpoint metadati | Descrizione |
---|---|
/computeMetadata/v1/project/numeric-project-id |
Il numero del progetto assegnato al tuo progetto. |
/computeMetadata/v1/project/project-id |
L'ID progetto assegnato al progetto. |
/computeMetadata/v1/instance/region |
La regione in cui è in esecuzione l'istanza. |
/computeMetadata/v1/instance/service-accounts/default/aliases |
|
/computeMetadata/v1/instance/service-accounts/default/email |
L'indirizzo email dell'account di servizio predefinito assegnato al progetto. |
/computeMetadata/v1/instance/service-accounts/default/ |
Elenca tutti gli account di servizio predefiniti per il tuo progetto. |
/computeMetadata/v1/instance/service-accounts/default/scopes |
Elenca tutti gli ambiti supportati per gli account di servizio predefiniti. |
/computeMetadata/v1/instance/service-accounts/default/token |
Restituisce il token di autenticazione che può essere utilizzato per autenticare l'applicazione in altre API Google Cloud. |
Ad esempio, per recuperare l'ID progetto, invia una richiesta a http://metadata.google.internal/computeMetadata/v1/project/project-id
.