Ambiente di runtime Python 3

Il runtime Python 3 è lo stack software responsabile dell'installazione del codice e delle sue dipendenze del servizio web e dell'esecuzione del servizio App Engine.

Il runtime Python 3 per App Engine nell'ambiente standard è dichiarato nel file app.yaml:

runtime: pythonVERSION

Dove VERSION è la versione MAJORMINOR di Python. Ad esempio, Python 3.12 utilizza 312.

Per le altre versioni di Python supportate e la versione di Ubuntu corrispondente alla tua versione Python, consulta la pianificazione del supporto dell'esecuzione.

Versioni Python 3

Il runtime Python 3 utilizza l'ultima release stabile della versione specificata nel file app.yaml. App Engine si aggiorna automaticamente alle nuove versioni della patch, ma non alla versione secondaria.

Ad esempio, il deployment della tua applicazione potrebbe essere eseguito in Python 3.7.0 e successivamente in Python 3.7.1, ma non verrà eseguito automaticamente l'aggiornamento alla versione secondaria successiva di 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 gratuitamente

App Engine esegue le app Python 3 in un container protetto da gVisor su una distribuzione Ubuntu Linux aggiornata.

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 root del progetto. Non è necessario caricare le dipendenze perché App Engine esegue una nuova installazione.

La specifica delle dipendenze utilizzando lo standard Pipfile/Pipfile.lock non è attualmente supportata e il tuo 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 punto di ingresso del server web Gunicorn nel file app.yaml, devi anche aggiungere gunicorn al tuo 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 del routing delle richieste ai gestori appropriati nella tua app.

Se l'app soddisfa i requisiti seguenti, App Engine avvierà l'app con il server web gunicorn se non specifichi il campo entrypoint:

• La directory principale della directory dell'app contiene un file main.py con un oggetto compatibile con WSGI chiamato app.

• La tua app non contiene file Pipfile o Pipfile.lock.

Se non specifichi un entrypoint per il runtime Python 3, App Engine configura e avvia il server web Gunicorn predefinito.

Nota: la durata del campo default timeout of gunicorn è di 30 secondi dopo aver specificato il campo entrypoint. I worker silenziosi per più di questi secondi vengono terminati e riavviati. Se il gestore impiega più di 30 secondi, potresti riscontrare [CRITICAL] WORKER TIMEOUT errore. Per assicurarti che la richiesta venga completata correttamente, in base al tuo caso d'uso, puoi utilizzare -- timeout flag nel campo del punto di ingresso per aumentare il timeout.

Best practice per i punti di ingresso

• Assicurati che il modulo Python necessario per eseguire il punto di ingresso specificato in app.yaml sia presente nel file requirements.txt. Aggiungi gunicorn al file requirements.txt solo se un endpoint gunicorn è specificato esplicitamente nel file app.yaml.

• Per ottenere prestazioni ottimali, il punto di ingresso deve essere leggero perché viene eseguito ogni volta che viene creata una nuova istanza della tua applicazione.

• Puoi utilizzare il campo del punto di ingresso per ottimizzare le prestazioni dell'app. Ad esempio, se usi gunicorn come server web, puoi usare 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 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

  Questa guida funge da punto di partenza per selezionare il numero di worker. Potresti dover utilizzare un numero diverso di worker a seconda delle caratteristiche delle prestazioni della tua app. L'esempio seguente mostra un deployment 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 tua variabile di ambiente $PORT. L'utilizzo della porta predefinita 8080 impedisce ad App Engine di utilizzare il suo livello NGINX per comprimere le risposte HTTP. Tieni presente che se utilizzi la porta 8080, nei file di log dell'app verranno visualizzati avvisi relativi alla porta 8080 e NGINX.

Altri framework web

Oltre a Django e Flask, puoi utilizzare altri framework web con App Engine, come uwsgi e Tornado. L'esempio seguente mostra come utilizzare uwsgi con App Engine:

runtime: python39
entrypoint: uwsgi --http-socket :$PORT --wsgi-file main.py --callable app --master --processes 1 --threads 2

uwsgi==2.0.22
Flask==3.0.0

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. 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 applicazione, in MB.
GAE_RUNTIME	Il runtime specificato nel file app.yaml.
GAE_SERVICE	Il nome del servizio specificato nel file app.yaml. Se non viene specificato alcun nome del 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 altre variabili di ambiente nel file app.yaml, ma i valori precedenti non possono essere sostituiti, ad eccezione di NODE_ENV.

HTTPS e proxy 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 nell'intestazione X-Forwarded-For standard. Le applicazioni che richiedono queste informazioni devono configurare il proprio framework web in modo da 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 di 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.

Nota: i metadati personalizzati non sono supportati nell'ambiente standard.

Puoi accedere al server 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.

Nella tabella seguente sono elencati gli endpoint in cui è possibile effettuare richieste HTTP per metadati specifici:

Endpoint dei metadati	Descrizione
/computeMetadata/v1/project/numeric-project-id	Il numero di progetto assegnato al 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 su altre API Google Cloud.

Ad esempio, per recuperare il tuo ID progetto, invia una richiesta a http://metadata.google.internal/computeMetadata/v1/project/project-id.