Panoramica di App Engine

ID regione

REGION_ID è un codice abbreviato assegnato da Google in base alla regione selezionata quando crei l'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 di App Engine. Per le app esistenti create prima di questa data, l'ID regione è facoltativo nell'URL.

Scopri di più sugli ID regione.

Un'app App Engine è costituita da una singola risorsa dell'applicazione composta da uno o più servizi. Ogni servizio può essere configurato per utilizzare diversi runtime e per funzionare con impostazioni di prestazioni diverse. All'interno di ciascun servizio, esegui il deployment delle versioni del servizio. Ogni versione viene quindi eseguita in una o più istanze, a seconda della quantità di traffico che hai configurato per gestirla.

Componenti di un'applicazione

L'app App Engine viene creata nel tuo progetto Google Cloud quando crei una risorsa applicazione. L'applicazione App Engine è un contenitore di primo livello che include le risorse di servizio, versione e istanza che compongono l'app. Quando crei la tua app App Engine, tutte le risorse vengono create nella regione che scegli, incluso il codice dell'app insieme a una raccolta di impostazioni, credenziali e metadati dell'app.

Ogni applicazione App Engine include almeno un servizio, il servizio default, che può contenere molte versioni, a seconda dello stato di fatturazione dell'app. Per ulteriori informazioni, consulta Limiti di seguito.

Il seguente diagramma illustra la gerarchia di un'app App Engine in esecuzione con più servizi. In questo diagramma, l'app ha due servizi che contengono più versioni e due di queste versioni sono in esecuzione attiva su più istanze:

Grafico della gerarchia dei servizi, delle versioni e delle istanze di un'app

Altri servizi Google Cloud, ad esempio Datastore, sono condivisi nell'app App Engine. Per saperne di più, consulta Strutturare i servizi web.

Servizi

Utilizza i servizi in App Engine per suddividere le app di grandi dimensioni in componenti logici che possono condividere in modo sicuro le funzionalità di App Engine e comunicare tra loro. In genere, i servizi App Engine si comportano come microservizi. Di conseguenza, puoi eseguire l'intera app in un unico servizio oppure puoi progettare e eseguire il deployment di più servizi da eseguire come un insieme di microservizi.

Ad esempio, un'app che gestisce le richieste dei clienti potrebbe includere servizi distinti che gestiscono ciascuno attività diverse, ad esempio:

Richieste API da dispositivi mobili
Richieste interne di tipo amministrativo
Elaborazione di backend, come pipeline di fatturazione e analisi dei dati

Ogni servizio in App Engine è costituito dal codice sorgente della tua app e dai file di configurazione di App Engine corrispondenti. L'insieme di file che esegui il deployment in un servizio rappresenta una singola versione di quel servizio e ogni volta che esegui il deployment in quel servizio, crei versioni aggiuntive all'interno dello stesso servizio.

Versioni

Avere più versioni dell'app all'interno di ciascun servizio ti consente di passare rapidamente da una versione all'altra per rollback, test o altri eventi temporanei. Puoi indirizzare il traffico a una o più versioni specifiche della tua app tramite la migrazione o la suddivisione del traffico.

Istanze

Le versioni all'interno dei servizi vengono eseguite su una o più istanze. Per impostazione predefinita, App Engine scala l'app in base al carico. Le tue app aumenteranno il numero di istanze in esecuzione per fornire prestazioni costanti o fare lo scale down il numero di istanze inattive per ridurre al minimo i costi. Per saperne di più sulle istanze, consulta Come vengono gestite le istanze.

Richieste di applicazione

Ogni servizio della tua app e ogni versione all'interno di questi servizi deve avere un nome univoco. Puoi quindi utilizzare questi nomi univoci per scegliere come target e indirizzare il traffico verso risorse specifiche utilizzando gli URL, ad esempio:

https://VERSION-dot-SERVICE-dot-PROJECT_ID.REGION_ID.r.appspot.com

Tieni presente che la lunghezza combinata di VERSION-dot-SERVICE-dot-PROJECT_ID, dove VERSION è il nome della versione, SERVICE è il nome del servizio e PROJECT_ID è l'ID progetto, non può superare i 63 caratteri e non può iniziare o terminare con un trattino. Se la lunghezza combinata è superiore a 63 caratteri, potresti visualizzare l'errore DNS address could not be found.

Le richieste degli utenti in arrivo vengono instradate ai servizi o alle versioni configurati per gestire il traffico. Puoi anche scegliere come target e instradare le richieste a servizi e versioni specifici. Per ulteriori informazioni, consulta la sezione Gestione delle richieste.

Log delle richieste delle applicazioni

Quando l'applicazione gestisce una richiesta, può anche scrivere i propri messaggi di logging in stdout e stderr. Per informazioni dettagliate sui log della tua app, consulta Scrivere log dell'applicazione.

Limiti

Il numero massimo di servizi e versioni che puoi implementare dipende dal prezzo dell'app:

Limite	App gratuita	App a pagamento
Numero massimo di servizi per app	5	210
Versioni massime per app	15	210

Esiste anche un limite al numero di istanze per ogni servizio con la scalabilità di base o manualmente:

Istanze massime per versione di scalabilità manuale/di base
App gratuita	App a pagamento Stati Uniti	App a pagamento nell'UE
20	25 (200 per `us-central`)	25

Esiste anche un limite al numero di caratteri nell'URL della tua applicazione.

Descrizione	Limite
Numero massimo di caratteri nell'URL del progetto per l'URL `VERSION-dot-SERVICE-dot-PROJECT_ID`	63