Ambiente di runtime Python 3

Il runtime Python è lo stack software responsabile dell'installazione il codice del tuo servizio web e le sue dipendenze ed eseguire 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 Ubuntu corrispondente per il tuo Per la versione 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 secondaria.

Ad esempio, il deployment dell'applicazione potrebbe essere eseguito in Python 3.7.0 e versioni successive. aggiornato automaticamente a Python 3.7.1, ma non sarà aggiornato automaticamente alla successiva versione secondaria 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 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 è attualmente non è supportato e il progetto non deve avere 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'instradamento delle richieste al i gestori appropriati nella tua 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 denominato app.

  • L'app non contiene file Pipfile o Pipfile.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 sia necessario per eseguire il punto di ingresso specificato app.yaml è presente nel file requirements.txt. Aggiungi gunicorn a requirements.txt solo se un endpoint gunicorn è stato specificato esplicitamente nel file app.yaml.

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

  • Puoi utilizzare il campo del punto di ingresso per ottimizzare le prestazioni della tua app. Per Ad esempio, se usi gunicorn come server web, puoi utilizzare --workers flag nel campo del punto di ingresso per configurare il numero di worker che gestiscono la tua app.

    Il numero di worker specificato deve corrispondere al valore 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 di worker. 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. Viene utilizzata la porta predefinita 8080 impedisce ad App Engine di usare il suo livello NGINX per comprimere i protocolli HTTP diverse. Tieni presente che se utilizzi la porta 8080, gli avvisi su la porta 8080 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:

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 distribuite 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 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 forwarding

App Engine termina le connessioni HTTPS al bilanciatore del carico 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 di la località /tmp, ovvero un disco virtuale per l'archiviazione di dati la 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 tuo 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'intenzione di recuperare i valori dei metadati.

La tabella seguente elenca gli endpoint per i quali è possibile effettuare richieste HTTP 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.