Panoramica di App Engine

ID regione

Il REGION_ID è un codice abbreviato che Google assegna 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 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 applicazione che include uno o più servizi. Ogni servizio può essere configurato per utilizzare runtime diversi e per operare con impostazioni delle prestazioni diverse. All'interno di ogni 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 gestire.

Componenti di un'applicazione

La tua 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 la tua app. Quando crei l'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 la sezione 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 gerarchico di servizi, versioni e istanze di un'app

Altri servizi Google Cloud , ad esempio Datastore, sono condivisi tra le app App Engine. Per maggiori informazioni, 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. Pertanto, puoi eseguire l'intera app in un unico servizio oppure progettare ed 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 separati che gestiscono ciascuno attività diverse, ad esempio:

  • Richieste API da dispositivi mobili
  • Richieste interne di tipo amministrativo
  • Elaborazione backend, ad esempio 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 deploy a un servizio rappresenta una singola versione di quel servizio e ogni volta che esegui il deployment al servizio, crei versioni aggiuntive all'interno dello stesso servizio.

Versioni

La presenza di più versioni dell'app all'interno di ogni servizio ti consente di passare rapidamente da una versione all'altra per rollback, test o altri eventi temporanei. Puoi instradare il traffico verso una o più versioni specifiche della tua app tramite migrazione o 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 per ridurre al minimo le istanze inattive e i costi. Per saperne di più sulle istanze, consulta Come vengono gestite le istanze.

Richieste di applicazioni

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 a 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 tua versione, SERVICE è il nome del tuo servizio e PROJECT_ID è il tuo 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 utente in entrata vengono indirizzate ai servizi o alle versioni configurati per gestire il traffico. Puoi anche scegliere come target e indirizzare le richieste a servizi e versioni specifici. Per maggiori informazioni, consulta Gestione delle richieste.

Registrazione delle richieste dell'applicazione

Quando la tua applicazione gestisce una richiesta, può anche scrivere i propri messaggi di logging in stdout e stderr. Per informazioni dettagliate sui log della tua app, vedi Scrittura dei log delle applicazioni.

Limiti

Il numero massimo di servizi e versioni che puoi eseguire il deployment dipende dai prezzi della tua app:

Limite App senza costi App a pagamento
Numero massimo di servizi per app 5 210
Numero massimo di versioni per app 15 210

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

Numero massimo di istanze per versione di scalabilità manuale/di base
App senza costi App a pagamento USA App a pagamento 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