ID regione
Il REGION_ID
è un codice abbreviato che Google assegna
in base alla regione selezionata durante la creazione dell'app. Il codice non
corrisponde a un paese o a una provincia, anche se alcuni ID regione possono sembrare
simili ai codici di paesi e province di uso comune. Per le app create dopo
febbraio 2020, REGION_ID.r
è incluso negli
URL App Engine. Per le app esistenti create prima di questa data, l'ID regione è facoltativo nell'URL.
Scopri di più sugli ID regione.
Questo documento descrive come l'applicazione App Engine riceve le richieste e invia le risposte.
Per maggiori dettagli, consulta la guida di riferimento per intestazioni e risposte delle richieste.
Se la tua applicazione utilizza servizi, puoi indirizzare le richieste a un servizio specifico o a una versione specifica di quel servizio. Per ulteriori informazioni sull'indirizzabilità del servizio, vedi Come vengono instradate le richieste.
Gestione delle richieste
La tua applicazione è responsabile dell'avvio di un web server e della gestione delle richieste. Puoi utilizzare qualsiasi framework web disponibile per il tuo linguaggio di sviluppo.
App Engine esegue più istanze dell'applicazione e ogni
istanza ha il proprio server web per la gestione delle richieste. Qualsiasi richiesta può essere indirizzata
a qualsiasi istanza, quindi le richieste consecutive dello stesso utente non vengono necessariamente
inviate alla stessa istanza. Un'istanza può gestire più richieste contemporaneamente. Il numero di istanze può essere modificato automaticamente in base alle variazioni del traffico.
Puoi anche modificare il numero di richieste simultanee che un'istanza può gestire
impostando l'elemento max_concurrent_requests
nel file app.yaml.
Il server determina quale script di gestione PHP eseguire confrontando l'URL della richiesta con i pattern URL nel file di configurazione app.yaml
dell'app. Quindi esegue lo script compilato con i dati della richiesta. Il
server inserisce i dati della richiesta nelle variabili di ambiente e nel flusso di input standard. Lo script esegue le azioni appropriate alla richiesta, quindi prepara una
risposta e la inserisce nel flusso di output standard.
L'esempio seguente è uno script PHP che risponde a qualsiasi richiesta HTTP con il messaggio "Hello World!".
Quote e limiti
App Engine alloca automaticamente le risorse alla tua applicazione man mano che il traffico aumenta. Tuttavia, questa operazione è vincolata alle seguenti limitazioni:
App Engine riserva la capacità di scalabilità automatica per le applicazioni con bassa latenza, in cui l'applicazione risponde alle richieste in meno di un secondo.
Le applicazioni con un elevato utilizzo della CPU potrebbero anche comportare una latenza aggiuntiva per condividere in modo efficiente le risorse con altre applicazioni sugli stessi server. Le richieste di file statici sono esenti da questi limiti di latenza.
Ogni richiesta in entrata all'applicazione viene conteggiata ai fini del limite di Richieste. I dati inviati in risposta a una richiesta vengono conteggiati ai fini del limite di larghezza di banda in uscita (fatturabile).
Le richieste HTTP e HTTPS (sicure) vengono conteggiate ai fini dei limiti di Richieste, Larghezza di banda in entrata (fatturabile) e Larghezza di banda in uscita (fatturabile). La Google Cloud console pagina Dettagli quota riporta anche Richieste sicure, Larghezza di banda in entrata sicura e Larghezza di banda in uscita sicura come valori separati a scopo informativo. Ai fini di questi valori, vengono conteggiate solo le richieste HTTPS. Per ulteriori informazioni, consulta la pagina Quote.
I seguenti limiti si applicano specificamente all'utilizzo dei gestori delle richieste:
Limite | Quantità |
---|---|
Dimensioni richiesta | 32 megabyte |
Dimensione della risposta | 32 megabyte |
Timeout richiesta | Dipende dal tipo di scalabilità utilizzato dalla tua app |
Numero totale massimo di file (file dell'app e file statici) | 10.000 totali 1000 per directory |
Dimensione massima di un file dell'applicazione | 32 megabyte |
Dimensione massima di un file statico | 32 megabyte |
Dimensione totale massima di tutti i file statici e dell'applicazione | Il primo gigabyte è gratuito $ 0,026 per gigabyte al mese dopo il primo gigabyte |
Timeout della richiesta in attesa | 10 secondi |
Dimensione massima di un singolo campo di intestazione della richiesta | 8 kilobyte per i runtime di seconda generazione nell'ambiente standard. Le richieste a questi runtime con campi di intestazione superiori a 8 kilobyte restituiranno errori HTTP 400. |
Limiti per le richieste
Tutte le richieste HTTP/2 verranno convertite in richieste HTTP/1.1 quando vengono inoltrate al server delle applicazioni.
Limiti di risposta
Le risposte dinamiche sono limitate a 32 MB. Se un gestore di script genera una risposta superiore a questo limite, il server restituisce una risposta vuota con un codice di stato 500 Internal Server Error. Questa limitazione non si applica alle risposte che pubblicano dati da Cloud Storage.
Il limite dell'intestazione della risposta è di 8 KB per gli runtime di seconda generazione. Le intestazioni di risposta che superano questo limite restituiranno errori HTTP 502, con log che mostrano
upstream sent too big header while reading response header from upstream
.
Intestazioni delle richieste
Una richiesta HTTP in entrata include le intestazioni HTTP inviate dal client. Per motivi di sicurezza, alcune intestazioni vengono sanificate o modificate da proxy intermedi prima di raggiungere l'applicazione.
Per maggiori informazioni, consulta la documentazione di riferimento delle intestazioni delle richieste.
Gestione dei timeout delle richieste
App Engine è ottimizzato per le applicazioni con richieste di breve durata, in genere quelle che richiedono poche centinaia di millisecondi. Un'app efficiente risponde rapidamente alla maggior parte delle richieste. Un'app che non lo fa non verrà scalata correttamente con l'infrastruttura di App Engine. Per garantire questo livello di prestazioni, esiste un timeout della richiesta massimo imposto dal sistema a cui ogni app deve rispondere.
Se uno script PHP supera questa scadenza, viene impostato il bitTIMEOUT
nel campo di bit connection
status. Lo script avrà quindi una breve seconda scadenza per completare le attività
di lunga durata e restituire una risposta all'utente.
Se lo script non ha restituito una risposta entro la seconda scadenza, il gestore viene interrotto e viene restituita una risposta di errore predefinita.
Risposte
App Engine chiama lo script con l'array$_REQUEST
compilato,
memorizza nel buffer qualsiasi output dello script e, al termine dell'esecuzione dello script,
invia l'output memorizzato nel buffer all'utente finale.
Esistono limiti di dimensione che si applicano alla risposta che generi e la risposta potrebbe essere modificata prima di essere restituita al client.
Per maggiori informazioni, consulta la documentazione di riferimento sulle risposte alle richieste.Risposte dinamiche
App Engine non supporta le risposte in streaming in cui i dati vengono inviati in blocchi incrementali al client durante l'elaborazione di una richiesta. Tutti i dati del tuo codice vengono raccolti come descritto sopra e inviati come una singola risposta HTTP.
Compressione delle risposte
App Engine fa del suo meglio per pubblicare contenuti compressi (gzip) per i client che lo supportano. Per determinare se i contenuti devono essere compressi, App Engine esegue le seguenti operazioni quando riceve una richiesta:Conferma se il client può ricevere in modo affidabile risposte compresse visualizzando le intestazioni
Accept-Encoding
eUser-Agent
nella richiesta. Questo approccio evita alcuni bug noti con i contenuti compressi con gzip nei browser più diffusi.Conferma se la compressione dei contenuti è appropriata visualizzando l'intestazione
Content-Type
che hai configurato per l'handler di risposta. In generale, la compressione è adatta ai tipi di contenuti basati su testo e non ai tipi di contenuti binari.
Tieni presente quanto segue:
Un client può forzare la compressione dei tipi di contenuti basati su testo impostando entrambe le intestazioni della richiesta
Accept-Encoding
eUser-Agent
sugzip
.Se una richiesta non specifica
gzip
nell'intestazioneAccept-Encoding
, App Engine non comprimerà i dati di risposta.Il frontend di Google memorizza nella cache le risposte dei gestori di file statici e delle directory di App Engine. A seconda di una serie di fattori, ad esempio il tipo di dati di risposta memorizzati nella cache per primi, le intestazioni
Vary
specificate nella risposta e le intestazioni incluse nella richiesta, un client potrebbe richiedere dati compressi ma ricevere dati non compressi e viceversa. Per maggiori informazioni, consulta Memorizzazione nella cache delle risposte.
Memorizzazione nella cache delle risposte
Il frontend di Google e potenzialmente il browser dell'utente e altri proxy server di memorizzazione nella cache intermedi memorizzeranno nella cache le risposte della tua app come indicato dalle intestazioni di memorizzazione nella cache standard che specifichi nella risposta. Puoi specificare queste intestazioni di risposta tramite il framework, direttamente nel codice o tramite i gestori di file e directory statici di App Engine.
Nel frontend di Google, la chiave della cache è l'URL completo della richiesta.
Memorizzazione nella cache dei contenuti statici
Per garantire che i client ricevano sempre contenuti statici aggiornati non appena vengono
pubblicati, ti consigliamo di pubblicare contenuti statici da directory con controllo delle versioni, ad esempio css/v1/styles.css
. Il frontend di Google non convaliderà
la cache (non verificherà la presenza di contenuti aggiornati) finché non scade. Anche dopo la scadenza della cache, questa non verrà aggiornata finché i contenuti all'URL della richiesta non cambiano.
Le seguenti intestazioni di risposta che puoi
impostare in
app.yaml
influenzano come e quando il frontend di Google memorizza nella cache i contenuti:
Cache-Control
deve essere impostato supublic
affinché il frontend di Google memorizzi nella cache i contenuti; questi potrebbero anche essere memorizzati nella cache dal frontend di Google, a meno che tu non specifichi un'istruzioneCache-Control
private
ono-store
. Se non imposti questa intestazione inapp.yaml
, App Engine la aggiunge automaticamente a tutte le risposte gestite da un gestore di file o directory statici. Per ulteriori informazioni, consulta la sezione Intestazioni aggiunte o sostituite.Vary
: per consentire alla cache di restituire risposte diverse per un URL in base alle intestazioni inviate nella richiesta, imposta uno o più dei seguenti valori nell'intestazione della rispostaVary
:Accept
,Accept-Encoding
,Origin
oX-Origin
.A causa della potenziale cardinalità elevata, i dati non verranno memorizzati nella cache per altri valori di
Vary
.Ad esempio:
Specifica la seguente intestazione della risposta:
Vary: Accept-Encoding
La tua app riceve una richiesta che contiene l'intestazione
Accept-Encoding: gzip
. App Engine restituisce una risposta compressa e Google Frontend memorizza nella cache la versione compressa dei dati di risposta. Tutte le richieste successive per questo URL che contengono l'intestazioneAccept-Encoding: gzip
riceveranno i dati compressi con gzip dalla cache finché la cache non viene invalidata (a causa della modifica dei contenuti dopo la scadenza della cache).La tua app riceve una richiesta che non contiene l'intestazione
Accept-Encoding
. App Engine restituisce una risposta non compressa e Google Frontend memorizza nella cache la versione non compressa dei dati di risposta. Tutte le richieste successive per questo URL che non contengono l'intestazioneAccept-Encoding
riceveranno i dati compressi dalla cache finché la cache non diventa non valida.
Se non specifichi un'intestazione di risposta
Vary
, il frontend di Google crea una singola voce della cache per l'URL e la utilizzerà per tutte le richieste indipendentemente dalle intestazioni della richiesta. Ad esempio:- Non specifichi l'intestazione della risposta
Vary: Accept-Encoding
. - Una richiesta contiene l'intestazione
Accept-Encoding: gzip
e la versione compressa dei dati di risposta verrà memorizzata nella cache. - Una seconda richiesta non contiene l'intestazione
Accept-Encoding: gzip
. Tuttavia, poiché la cache contiene una versione compressa con gzip dei dati di risposta, la risposta verrà compressa con gzip anche se il client ha richiesto dati non compressi.
Anche le intestazioni della richiesta influiscono sulla memorizzazione nella cache:
- Se la richiesta contiene un'intestazione
Authorization
, i contenuti non verranno memorizzati nella cache del frontend di Google.
Scadenza della cache
Per impostazione predefinita, le intestazioni di memorizzazione nella cache che i gestori di file statici e directory di App Engine aggiungono alle risposte indicano ai client e ai proxy web, come Google Frontend, di scadere la cache dopo 10 minuti.
Una volta trasmesso un file con un determinato tempo di scadenza, in genere non è possibile cancellarlo dalle cache dei proxy web, anche se l'utente svuota la propria cache del browser. Il redeployment di una nuova versione dell'app non reimposterà le cache. Pertanto, se prevedi di modificare un file statico, questo deve avere un tempo di scadenza breve (inferiore a un'ora). Nella maggior parte dei casi, il tempo di scadenza predefinito di 10 minuti è appropriato.
Puoi modificare la scadenza predefinita per tutti i gestori di file e directory statici
specificando l'elemento
default_expiration
nel file
app.yaml
. Per impostare tempi di scadenza specifici per i singoli
gestori,
specifica l'elemento expiration
all'interno dell'elemento gestore nel file
app.yaml
.
Il valore specificato nell'ora degli elementi di scadenza verrà utilizzato per
impostare le intestazioni della risposta HTTP Cache-Control
e Expires
.
Memorizzazione nella cache delle app
L'ambiente di runtime PHP include OPcache, che può memorizzare nella cache il codice intermedio PHP e migliorare significativamente il tempo di risposta dell'applicazione. Puoi disattivare la memorizzazione nella cache di OPcache impostandoopcache.enabled = "0"
nel file php.ini dell'applicazione.
Logging
Il server web App Engine acquisisce tutto ciò che lo script del gestore scrive nel flusso di output standard per la risposta alla richiesta web. Inoltre, acquisisce tutto ciò che lo script del gestore scrive nel flusso di errori standard e lo memorizza come dati di log. I dati di log per la tua applicazione possono essere visualizzati nella consoleGoogle Cloud utilizzando Cloud Logging.L'ambiente di runtime PHP di App Engine include il supporto per la registrazione
di messaggi arbitrari dalla tua applicazione utilizzando la funzione
syslog()
integrata di PHP
, che richiama l'API Logs.
L'ambiente
Forzare le connessioni HTTPS
Per motivi di sicurezza, tutte le applicazioni devono incoraggiare i client a connettersi tramite
https
. Per indicare al browser di preferire https
a http
per una determinata pagina o per l'intero dominio, imposta l'intestazione Strict-Transport-Security
nelle risposte.
Ad esempio:
Strict-Transport-Security: max-age=31536000; includeSubDomains
Gestione del lavoro asincrono in background
Il lavoro in background è qualsiasi lavoro che la tua app esegue per una richiesta dopo aver fornito la risposta HTTP. Evita di eseguire operazioni in background nella tua app e controlla il codice per assicurarti che tutte le operazioni asincrone terminino prima di fornire la risposta.
Per i job a esecuzione prolungata, consigliamo di utilizzare Cloud Tasks. Con Cloud Tasks, le richieste HTTP sono di lunga durata e restituiscono una risposta solo al termine di qualsiasi lavoro asincrono.