Il runtime Python è lo stack software responsabile dell'installazione del codice del servizio web e delle relative dipendenze ed esegue il servizio App Engine.
Il runtime Python per App Engine nell'ambiente standard è
dichiarato in app.yaml
file:
runtime: pythonVERSION
Dove VERSION sono i numeri di versione Python di MAJOR
e MINOR
. Per
Ad esempio, per utilizzare l'ultima versione Python, Python 3.12, specifica
312
.
Per altre versioni di Python supportate e la versione di Ubuntu corrispondente alla tua versione di Python, consulta la pianificazione del supporto del runtime.
Versioni Python 3
Il runtime Python utilizza l'ultima release stabile del
specificata nel file app.yaml
.
App Engine si aggiorna automaticamente alle nuove versioni delle patch, ma non aggiorna automaticamente la versione minore.
Ad esempio, l'applicazione potrebbe essere dipiattaforma Python 3.7.0 e versioni successive e aggiornata automaticamente a Python 3.7.1, ma non verrà aggiornata automaticamente alla versione minore 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 un la distribuzione aggiornata di Ubuntu Linux.
Dipendenze
Durante il deployment, App Engine usa il gestore di pacchetti Python
pip
per installare le dipendenze
definita in requirements.txt
del file di metadati nella directory radice del progetto. Non è necessario
caricare le dipendenze quando App Engine esegue una nuova installazione.
La specifica delle dipendenze che utilizza lo standard Pipfile
/Pipfile.lock
non è attualmente supportata e il progetto non deve contenere questi file.
Avvio dell'applicazione
Il runtime avvia l'app eseguendo il comando specificato nel
Campo entrypoint
nel file app.yaml
. Se hai configurato un server web Gunicorn
nel file app.yaml
, devi anche aggiungere gunicorn
al tuo
requirements.txt
file.
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'indirizzamento delle richieste agli gestori appropriati all'interno dell'app.
Se la tua app soddisfa i requisiti seguenti, App Engine avvia
la tua app con il server web gunicorn
se non
specifica il campo entrypoint
:
La directory principale della directory dell'app contiene un file
main.py
con un Oggetto compatibile con WSGI denominatoapp
.L'app non contiene file
Pipfile
oPipfile.lock
.
Se non specifichi un punto di contatto per il runtime di Python 3, App Engine configura e avvia il server web Gunicorn predefinito.
Best practice per il punto di ingresso
Assicurati che il modulo Python sia necessario per eseguire il punto di ingresso specificato
app.yaml
è presente nel filerequirements.txt
. Aggiungigunicorn
arequirements.txt
solo se un endpointgunicorn
è specificato esplicitamente nel fileapp.yaml
.Per ottenere le migliori prestazioni, il punto di contatto deve essere leggero perché viene eseguito ogni volta che viene creata una nuova istanza dell'applicazione.
Puoi utilizzare il campo entrypoint per ottimizzare il rendimento della tua app. Ad esempio, se utilizzi
gunicorn
come server web, puoi utilizzare il flag--workers
nel campo entrypoint per configurare il numero di worker che servono la tua app.Il numero di worker specificato deve corrispondere alla classe di istanza della tua 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 rappresentano un punto di partenza per selezionare il numero di lavoratori. Potresti dover utilizzare un numero diverso di worker a seconda delle caratteristiche prestazionali della tua app. L'esempio seguente mostra un deployment di App Engine che utilizza due
gunicorn
worker per la gestione delle app:entrypoint: gunicorn -b :$PORT -w 2 main:app
Ti consigliamo di configurare il tuo server web per l'ascolto e la risposta a HTTP richieste sulla porta specificata da
$PORT
variabile di ambiente. L'utilizzo 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 su la porta8080
e NGINX verranno visualizzate nei file di log dell'app.
Altri framework web
Oltre a Django e Flask, puoi utilizzare altri framework web con
ad App Engine,
uwsgi
e
Tornado
. L'esempio seguente mostra
come utilizzare uwsgi
con App Engine:
Variabili di ambiente
Le seguenti variabili di ambiente vengono impostate dal runtime:
Variabile di ambiente | Descrizione |
---|---|
GAE_APPLICATION
|
L'ID della tua applicazione App Engine. Questo ID è preceduto da "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. Impostato 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
definisci altre variabili di ambiente nel file app.yaml
,
ma non è possibile eseguire l'override dei valori precedenti, ad eccezione di NODE_ENV
.
Proxy HTTPS e di inoltro
App Engine termina le connessioni HTTPS al bilanciatore del carico e inoltra le richieste alla tua applicazione. Alcune applicazioni devono determinare
l'IP e il protocollo della richiesta originale. L'indirizzo IP dell'utente è disponibile in
l'intestazione X-Forwarded-For
standard. Applicazioni che lo richiedono
le informazioni devono configurare il framework web per considerare attendibile il proxy.
Filesystem
Il runtime include un file system completo. Il file system è di sola lettura, ad eccezione della posizione /tmp
, che è un disco virtuale che memorizza i dati nella RAM dell'istanza App Engine.
Server metadati
Ogni istanza dell'applicazione può utilizzare il server metadati di App Engine per eseguire query sulle informazioni sull'istanza e sul progetto.
Puoi accedere al server dei 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'intenzione di recuperare i valori dei metadati.
La tabella seguente elenca gli endpoint per i quali è possibile effettuare richieste HTTP metadati specifici:
Endpoint dei 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 i service account 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
.