ID regione
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 potrebbero essere 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.
Questa guida fornisce un'introduzione a Cloud Run per gli utenti che hanno familiarità con App Engine. Vengono illustrate le principali somiglianze e differenze tra le piattaforme serverless per aiutarti a prepararti alla migrazione dall'ambiente standard App Engine o dall'ambiente flessibile App Engine.
Panoramica
Cloud Run è l'ultima evoluzione del serverless di Google Cloud , basata sull'esperienza di esecuzione di App Engine per più di un decennio. Cloud Run viene eseguito su gran parte della stessa infrastruttura dell'ambiente standard di App Engine, quindi esistono molte somiglianze tra queste due piattaforme.
Cloud Run è progettato per migliorare l'esperienza di App Engine, incorporando molte delle migliori funzionalità sia dell'ambiente standard App Engine sia dell'ambiente flessibile App Engine. I servizi Cloud Run possono gestire gli stessi workload dei servizi App Engine, ma Cloud Run offre ai clienti molta più flessibilità nell'implementazione di questi servizi. Questa flessibilità, insieme a integrazioni migliorate con i servizi Google Cloud e di terze parti, consente inoltre a Cloud Run di gestire workload che non possono essere eseguiti su App Engine.
Riepilogo del confronto
Sebbene esistano molte somiglianze e differenze tra App Engine e Cloud Run, questa panoramica si concentra sulle aree più pertinenti per i clienti di App Engine che iniziano a utilizzare Cloud Run.
| ambiente standard App Engine | ambiente flessibile App Engine | Cloud Run | |||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Terminologia | Applicazione | N/D | |||||||||||||||||||
| Servizio | Servizio | ||||||||||||||||||||
| Versione | Revisione | ||||||||||||||||||||
Endpoint URL |
|||||||||||||||||||||
| URL dell'app
(servizio default)
|
https://PROJECT_ID.REGION_ID.r.appspot.com
|
N/D | |||||||||||||||||||
| URL del servizio |
https://SERVICE_ID-dot-PROJECT_ID.REGION_ID.r.appspot.com
|
|
|||||||||||||||||||
| URL della versione/revisione |
https://VERSION-dot-SERVICE-dot-PROJECT_ID.REGION_ID.r.appspot.com
|
|
|||||||||||||||||||
Scalabilità |
|||||||||||||||||||||
| Scalabilità automatica | Sì | Sì | Sì | ||||||||||||||||||
| Scalabilità manuale | Sì | Sì | Sì | ||||||||||||||||||
| Scalabilità fino a zero | Sì | No | Sì | ||||||||||||||||||
| Richieste di warmup | Configurabile | No | Automatico | ||||||||||||||||||
| Timeout dell'istanza inattiva (dopo il completamento dell'ultima richiesta) | Fino a 15 minuti | Dipende dall'impostazione Fatturazione. Utilizza la fatturazione basata sulle istanze per emulare il comportamento di App Engine | |||||||||||||||||||
| Timeout richiesta |
|
60 minuti | Configurabile fino a 60 minuti (valore predefinito: 5 minuti) | ||||||||||||||||||
Deployment |
|||||||||||||||||||||
| Dall'origine | Sì | Sì | |||||||||||||||||||
| Immagine container | No | Sì (runtime personalizzati) | Sì | ||||||||||||||||||
| Container sidecar | No | Sì. I sidecar vengono eseguiti insieme al container principale, gestendo le richieste web. | |||||||||||||||||||
| Controlli di integrità | Automatico. App Engine esegue controlli di idoneità e attività sulle tue istanze. | Configurabile. Puoi definire i probe di avvio e di attività in modo esplicito nella configurazione delle risorse Cloud Run e specificare dettagli come il tipo di probe (TCP, HTTP e gRPC), il percorso, la porta, il ritardo iniziale, il periodo, il timeout, la soglia di successo e la soglia di errore. | |||||||||||||||||||
Risorse di computing |
|||||||||||||||||||||
| vCPU |
|
Fino a 80 vCPU | Fino a 8 vCPU | ||||||||||||||||||
| Memoria | Fino a 6,5 GB per vCPU | Fino a 32 GB | |||||||||||||||||||
| GPU | No | Sì. Puoi configurare una GPU per istanza Cloud Run. | |||||||||||||||||||
| Punti di montaggio volume | No | Sì. Puoi montare un bucket Cloud Storage direttamente nel file system del container. | |||||||||||||||||||
Modello di determinazione del prezzo |
|||||||||||||||||||||
| Tariffa per richiesta | No |
No, se utilizzi la fatturazione basata sulle istanze. Sì, se utilizzi la fatturazione basata sulle richieste. |
|||||||||||||||||||
| Numero minimo di istanze inattive | Stesso costo delle istanze attive | Costo inferiore per le istanze minime inattive (consulta Tempo di istanza di container fatturabile) | |||||||||||||||||||
| Sconti per impegno di utilizzo (CUD) | No | Sì | |||||||||||||||||||
| Fatturazione basata sulle istanze (istanza con costo orario) | Istanza F4/B4: 0,2 $ |
|
|
||||||||||||||||||
Sicurezza |
|||||||||||||||||||||
| Impostazioni traffico in entrata | Sì | Sì | Sì | ||||||||||||||||||
| Ruolo Invoker | No | Sì | |||||||||||||||||||
| IAP | Sì | Sì | Sì | ||||||||||||||||||
| Firewall | Sì | Sì | Configura utilizzando Google Cloud Armor | ||||||||||||||||||
| Secret Manager | Sì, con le librerie client di Cloud. | Sì. Puoi montare ogni secret come volume o passarlo utilizzando le variabili di ambiente. | |||||||||||||||||||
Connettività |
|||||||||||||||||||||
| Domini personalizzati | Sì | Sì | Sì | ||||||||||||||||||
| Connettività VPC (incluso VPC condiviso) | Sì | N/D | Sì | ||||||||||||||||||
| Impostazioni traffico in uscita VPC | Sì | N/D | Sì | ||||||||||||||||||
| Bilanciamento del carico multi-regione | No | Sì | |||||||||||||||||||
| Streaming server | No | Sì | |||||||||||||||||||
Connettività - VPC diretto in uscita |
|||||||||||||||||||||
| Fase di lancio | GA | N/D | GA | ||||||||||||||||||
| Tag di rete | Supportato | N/D | Supportato | ||||||||||||||||||
| Log di flusso VPC | Supportato | N/D | Supportato | ||||||||||||||||||
| Public NAT | Supportato | N/D | Supportato | ||||||||||||||||||
| Private NAT | Supportato | N/D | Supportato | ||||||||||||||||||
| Subnet dual stack | Supportato | N/D | Supportato | ||||||||||||||||||
| Metodo di configurazione | YAML, Terraform | N/D | ConsoleGoogle Cloud , gcloud, YAML, Terraform | ||||||||||||||||||
| Supporto per il VPC condiviso | Supportato | N/D | Supportato | ||||||||||||||||||
Accesso ai servizi Google Cloud |
|||||||||||||||||||||
| Cloud SQL | Sì | Sì | Sì | ||||||||||||||||||
| Librerie client cloud | Se utilizzi le librerie client di Cloud in App Engine, non devi apportare modifiche durante la migrazione a Cloud Run. Queste librerie client funzionano ovunque, il che significa che la tua applicazione è più portabile. | ||||||||||||||||||||
| Servizi in bundle legacy di App Engine | Sì (solo Java, Python, Go, PHP) | No | No | ||||||||||||||||||
Modello di risorsa
Il modello di risorse di Cloud Run è molto simile a quello di App Engine, ma esistono alcune differenze fondamentali:
- Cloud Run non dispone di una risorsa Application di primo livello o del servizio
defaultcorrispondente. - È possibile eseguire il deployment dei servizi Cloud Run nello stesso progetto in regioni diverse. In App Engine, tutti i servizi del progetto si trovano nella stessa regione.
- Cloud Run utilizza il termine Revisione anziché Versione per allinearsi al modello di risorse Knative.
- I nomi delle revisioni di Cloud Run utilizzano il formato
SERVICE_NAME-REVISION_SUFFIX, doveREVISION_SUFFIXviene generato automaticamente o impostato utilizzando il flag di deployment--revision-suffix=REVISION_SUFFIX. - Le revisioni di Cloud Run sono immutabili, il che significa che non puoi riutilizzare i nomi come fai con le versioni di App Engine (utilizzando il flag di deployment
--version=VERSION_ID). - Gli URL dei servizi Cloud Run si basano su un identificatore del servizio generato automaticamente al primo deployment del servizio. Gli identificatori del servizio utilizzano il formato:
SERVICE_NAME-<auto-generated identifier>. L'identificatore del servizio è univoco e non cambia durante il ciclo di vita del servizio. - In Cloud Run, per impostazione predefinita vengono esposti solo gli URL del servizio (
SERVICE_IDENTIFIER.run.appehttps://SERVICE_NAME-PROJECT_NUMBER.REGION.run.app). Per indirizzare una revisione specifica, devi configurare un tag di traffico. In App Engine, gli URL del servizio e della versione vengono esposti automaticamente.
Deployment e configurazione
In App Engine, la maggior parte della configurazione viene eseguita nel file app.yaml incluso in ogni deployment. Questa semplicità ha un costo: sebbene alcune impostazioni possano essere aggiornate utilizzando l'API Admin, la maggior parte delle modifiche richiede il deployment del servizio.
Sebbene Cloud Run abbia il file di configurazione service.yaml, non viene utilizzato nello stesso modo di app.yaml. Il service.yaml di Cloud Run non può essere utilizzato durante il deployment dall'origine, poiché uno degli elementi richiesti è il percorso dell'immagine container finale. Inoltre, service.yaml è conforme alla specifica Knative e può essere difficile da leggere per chi non ha familiarità con i file di configurazione in stile Kubernetes. Per saperne di più sull'utilizzo di service.yaml per gestire la configurazione, consulta la documentazione di Cloud Run.
Per i clienti App Engine che iniziano a utilizzare Cloud Run, l'utilizzo dei flag di deployment di gcloud CLI è molto più simile alla gestione delle configurazioni di App Engine al momento del deployment.
Per impostare la configurazione durante il deployment del nuovo codice in Cloud Run, utilizza i flag gcloud run deploy:
gcloud run deploy SERVICE_NAME \
--cpu CPU \
--memory MEMORY \
--concurrency CONCURRENCY
Sebbene non sia necessario utilizzare i flag di configurazione con ogni deployment (consulta Gestione delle configurazioni), puoi farlo per semplificare la gestione delle configurazioni.
In Cloud Run, puoi anche aggiornare la configurazione senza rifare il deployment del codice sorgente utilizzando gcloud run services update:
gcloud run services update SERVICE_NAME \
--cpu CPU \
--memory MEMORY \
--concurrency CONCURRENCY
Poiché le revisioni di Cloud Run sono immutabili, questo comando creerà una nuova revisione con la configurazione aggiornata, ma utilizzerà la stessa immagine container della revisione esistente.
Gestione delle configurazioni
Per i deployment di App Engine, è necessario fornire tutte le impostazioni per ogni deployment. Alle impostazioni non fornite vengono assegnati valori predefiniti. Ad esempio, prendi App Engine service-a, con versioni che utilizzano i file app.yaml nella tabella seguente:
| Versione 1 del servizio App Engine | Versione 2 del servizio App Engine A |
|---|---|
| app.yaml | |
runtime: python39 service: service-a instance_class: F4 |
runtime: python39 service: service-a |
| Configurazione applicata | |
runtime: python39 service: service-a instance_class: F4 default values: |
runtime: python39 service: service-a default values: |
version1 è configurato con instance_class: F4, mentre version2, che non ha fornito alcun valore per instance_class, è configurato con il valore predefinito instance_class: F1.
Per Cloud Run, vengono applicate tutte le impostazioni di configurazione fornite, mentre quelle non fornite mantengono i valori esistenti. Devi fornire i valori solo per le impostazioni che vuoi modificare. Ad esempio:
| Revisione 1 del servizio Cloud Run A | Revisione 2 del servizio Cloud Run A |
|---|---|
| Comando di deployment | |
gcloud run deploy service-a \ --cpu=4 |
gcloud run deploy service-a |
| Configurazione applicata | |
service: service-a vCPUs: 4 default values: |
service: service-a vCPUs: 4 default values: |
In App Engine, il deployment senza impostazioni di configurazione crea una versione che utilizza tutte le impostazioni predefinite. In Cloud Run, il deployment senza impostazioni di configurazione crea una revisione utilizzando le stesse impostazioni di configurazione della revisione precedente. Per la prima revisione di un servizio Cloud Run, il deployment senza impostazioni di configurazione crea una revisione che utilizza tutte le impostazioni predefinite.
Valori predefiniti di configurazione
| Impostazione di configurazione | ambiente standard App Engine | ambiente flessibile App Engine | Cloud Run |
|---|---|---|---|
| Risorse di computing | F1 | 1 vCPU, 0,6 GB | 1 vCPU, 512MB |
| Concorrenza massima (richieste) | 10 | Nessuno | 80 |
| Timeout richiesta |
|
60 minuti | 5 minuti |
| Target di utilizzo della CPU | 60% | 50% | 60% |
| Numero massimo di istanze | Nessuno | 20 | 100 |
| Numero minimo di istanze | 0 | 2 | 0 |
Entry point
Quando esegui il deployment dal codice sorgente, App Engine legge il comando entrypoint dall'attributo entrypoint in app.yaml. Se non viene fornito alcun entry point, viene utilizzato un valore predefinito specifico per il runtime. Cloud Run utilizza i buildpack di Google Cloud durante il deployment dall'origine e alcuni linguaggi non hanno un entry point predefinito, il che significa che devi fornirne uno, altrimenti la build non andrà a buon fine. Ad esempio, i buildpack Python richiedono un file Procfile o la specifica della variabile di ambiente di build GOOGLE_ENTRYPOINT.
Consulta la documentazione dei buildpack per i requisiti di configurazione specifici del linguaggio.
Controlli di integrità
In App Engine, i controlli di integrità sono in gran parte automatici e gestiti dalla piattaforma. App Engine esegue controlli di attività e idoneità per determinare se un'istanza è operativa e pronta a gestire il traffico. Se un'istanza non supera costantemente i controlli automatici, App Engine la termina e la sostituisce con una nuova istanza per garantire la continuità del servizio.
Cloud Run offre un controllo più granulare con probe di avvio e di attività configurabili. Questi probe ti consentono di definire un'istanza integra, il che è fondamentale per i microservizi complessi.
In Cloud Run puoi configurare i seguenti probe:
Probe di avvio per definire quando un container è stato avviato ed è pronto a gestire il traffico. Quando configuri un probe di avvio, i controlli di attività vengono disattivati fino al completamento dell'avvio, in modo che i probe di attività non interferiscano con l'avvio dell'applicazione.
Probe di attività per determinare quando riavviare un container. Ad esempio, i probe di attività potrebbero rilevare un deadlock quando un'applicazione è in esecuzione, ma non è in grado di procedere. Il riavvio di un container in questo stato garantisce che l'applicazione sia disponibile nonostante i bug.
Per saperne di più, consulta Configura i controlli di integrità dei container per i servizi.
Scalabilità
Sebbene Cloud Run e l'ambiente standard di App Engine condividano un'infrastruttura di scalabilità simile, Cloud Run è ottimizzato per una scalabilità più rapida e funzionalità di scalabilità fino a zero. Ciò comporta un numero inferiore di impostazioni configurabili. Questa semplificazione limita le impostazioni configurabili a:
- Contemporaneità massima
- Numero massimo e minimo di istanze
- Controlli di scalabilità personalizzati per impostare l'utilizzo target per CPU e contemporaneità
Per impostazione predefinita, l'utilizzo target della CPU e della contemporaneità per un servizio Cloud Run è del 60%. Per ottimizzare costi e prestazioni, puoi personalizzare questi valori. Per saperne di più, consulta Configura i controlli di scalabilità personalizzati per i servizi.
L'ambiente flessibile App Engine utilizza il gestore della scalabilità automatica di Compute Engine, pertanto ha caratteristiche di scalabilità molto diverse rispetto all'ambiente standard App Engine e a Cloud Run.
Esegui la migrazione dei controlli di scalabilità da App Engine a Cloud Run
Questa sezione descrive come mappare la configurazione di scalabilità di App Engine esistente a Cloud Run.
Numero minimo di istanze (warm up)
Mantieni un numero minimo di istanze attive per gestire il traffico di base ed evitare gli avvii a freddo.
| Ambiente di configurazione | Impostazioni |
|---|---|
| ambiente standard App Engine | min_instances: N |
| ambiente flessibile App Engine | automatic_scaling:min_num_instances: N |
| Cloud Run | A livello di servizio: scaling.min_instance_count: N A livello di revisione: template.scaling.min_instance_count: N |
Strategia di migrazione: imposta il numero minimo di istanze per il preriscaldamento a livello di servizio. Se indirizzi il traffico a una revisione specifica, l'impostazione a livello di revisione sostituisce l'impostazione predefinita a livello di servizio. Utilizza questa impostazione per testare una nuova revisione con un numero minimo di istanze diverso prima di promuoverla in produzione.
Numero massimo di istanze
Imposta un limite massimo per il numero totale di istanze per il controllo dei costi e per proteggere le dipendenze downstream.
| Ambiente di configurazione | Impostazioni |
|---|---|
| ambiente standard App Engine | max_instances: N |
| ambiente flessibile App Engine | automatic_scaling:max_num_instances: N |
| Cloud Run | A livello di servizio: scaling.max_instance_count: N A livello di revisione: template.scaling.max_instance_count: N |
Strategia di migrazione: imposta un limite globale a livello di servizio. Cloud Run applica l'impostazione più bassa tra quelle a livello di servizio e di revisione. Per saperne di più, consulta Imposta il numero massimo di istanze per i servizi.
Concorrenza
Definisci la capacità di richiesta di una singola istanza.
| Ambiente di configurazione | Impostazioni |
|---|---|
| ambiente standard App Engine | max_concurrent_requests: N |
| ambiente flessibile App Engine | automatic_scaling:target_concurrent_requests: N |
| Cloud Run | template.maxInstanceRequestConcurrency: N |
Strategia di migrazione: segui una delle due strategie di migrazione:
Inizia con la capacità predefinita dell'istanza Cloud Run di 80 ed esegui test di carico per trovare il limite di contemporaneità stabile per la tua applicazione su Cloud Run. La regolazione di questo valore è un modo efficace per ottimizzare le prestazioni e i costi su Cloud Run. Modifica il valore verso il basso rispetto a 80 in base ai risultati del test. Per saperne di più, consulta Imposta il numero massimo di richieste in parallelo per istanza.
Utilizza il valore di configurazione esistente nell'ambiente standard App Engine, che per impostazione predefinita è di 10 richieste in parallelo per istanza. Questa è un'opzione sicura, perché si tratta di una configurazione nota e funzionante per la tua applicazione. Tuttavia, ciò potrebbe comportare un sottoutilizzo significativo delle istanze Cloud Run e costi potenzialmente più elevati, poiché il gestore della scalabilità automatica crea più istanze di quelle necessarie per gestire il carico.
Utilizzo CPU
Scalabilità quando il carico della CPU supera una determinata soglia.
| Ambiente di configurazione | Impostazioni |
|---|---|
| ambiente standard App Engine | target_cpu_utilization: 0.X |
| ambiente flessibile App Engine | automatic_scaling:cpu_utilization:target_utilization: N |
| Cloud Run | template.scaling.cpuUtilization: 0.X |
Strategia di migrazione: utilizza il flag --scaling-cpu-target per impostare una soglia di utilizzo della CPU personalizzata. Per impostazione predefinita, il gestore della scalabilità automatica di Cloud Run mantiene un utilizzo della CPU di circa il 60% sulle istanze attive. Per saperne di più, consulta Configura i controlli di scalabilità personalizzati per i servizi.
A differenza di App Engine, Cloud Run alloca la CPU solo durante l'elaborazione delle richieste e la limita a zero negli altri casi. Nell'ambiente standard App Engine, indipendentemente dal tipo di scalabilità configurato, App Engine si assicura che la CPU sia disponibile continuamente per la tua istanza.
Se la tua applicazione esegue un lavoro in background tra le richieste, ad esempio utilizzando thread in background nella scalabilità di base o manuale, configura la fatturazione basata su istanze in Cloud Run per evitare la sospensione delle attività di elaborazione in background.
Utilizzo concorrenza
Esegui lo scale up in base all'utilizzo della concorrenza quando l'applicazione raggiunge il limite di concorrenza.
| Ambiente di configurazione | Impostazioni |
|---|---|
| ambiente standard App Engine | target_throughput_utilization: 0.X |
| ambiente flessibile App Engine | Non disponibile |
| Cloud Run | template.scaling.concurrencyUtilization: 0.X |
Strategia di migrazione: utilizza il flag --scaling-concurrency-target per definire la soglia di utilizzo target per la contemporaneità. Per impostazione predefinita, il gestore della scalabilità automatica di Cloud Run tenta di mantenere il numero di richieste in parallelo per istanza al 60% del valore del numero massimo di richieste in parallelo per istanza.
Per saperne di più, consulta Configura i controlli di scalabilità personalizzati per i servizi.
Quando imposti questo valore, definisci il throughput target che attiva un evento di scale up.
Latenza
Definisci una finestra temporale di attesa dell'utente che attiva lo scale up. App Engine è parzialmente reattivo alla coda delle richieste.
| Ambiente di configurazione | Impostazioni |
|---|---|
| ambiente standard App Engine | min_pending_latency e max_pending_latency |
| ambiente flessibile App Engine | Non disponibile |
| Cloud Run | Nessun equivalente diretto |
Strategia di migrazione: Cloud Run esegue la scalabilità automatica prima che le richieste inizino a mettersi in coda e che si verifichino picchi di latenza. Se si verificano picchi di latenza, valuta la possibilità di ottimizzare il valore del numero massimo di richieste in parallelo per istanza per garantire uno scale out più rapido.
Istanze inattive
Intent: in App Engine, le impostazioni delle istanze inattive controllano un pool di istanze inattive preriscaldate che assorbono i picchi di traffico e controllano i costi.
| Ambiente di configurazione | Impostazioni |
|---|---|
| ambiente standard App Engine | min_idle_instances: N o max_idle_instances: N |
| ambiente flessibile App Engine | Non disponibile |
| Cloud Run | Nessun equivalente diretto |
Strategia di migrazione: non puoi configurare un numero minimo o massimo di istanze inattive separato in Cloud Run. Per mantenere le istanze attive e pronte per il traffico immediato e mitigare gli avvii a freddo in Cloud Run, utilizza l'impostazione scaling.min_instance_count, che garantisce che un numero minimo specificato di container sia sempre in esecuzione. Per saperne di più, consulta Informazioni sulla scalabilità automatica delle istanze nei servizi Cloud Run.
Timeout istanza inattiva
In App Engine, le istanze inattive rimangono attive per circa 15 minuti dopo l'ultima richiesta. Cloud Run controlla questo comportamento utilizzando l'impostazione di fatturazione.
Per ottenere un comportamento di fatturazione simile a quello di App Engine, in cui la CPU viene allocata al di fuori dell'elaborazione delle richieste, utilizza la fatturazione basata sulle istanze in Cloud Run.
In alternativa, utilizza la fatturazione basata sulle richieste per allocare la CPU solo durante l'elaborazione delle richieste. Con questa impostazione, l'istanza rimarrà attiva per un massimo di 15 minuti dopo l'ultima richiesta, ma la CPU verrà limitata durante questo periodo di inattività.
Scalabilità di base
| Ambiente di configurazione | Impostazioni |
|---|---|
| ambiente standard App Engine | basic_scaling: max_instances: N |
| ambiente flessibile App Engine | Non disponibile |
| Cloud Run | Scalabilità automatica predefinita. scaling.min_instance_count: 0 scaling.max_instance_count: N |
Quando configuri l'impostazione basic_scaling nell'ambiente standard App Engine, vengono create istanze quando riceve richieste e viene applicato lo scale down a zero dopo un periodo di inattività. Puoi replicare questo comportamento in Cloud Run utilizzando la scalabilità automatica impostando min-instances su 0.
Scalabilità manuale
Eseguire un numero fisso di istanze e disattivare la scalabilità automatica.
| Ambiente di configurazione | Impostazioni |
|---|---|
| ambiente standard App Engine | manual_scaling: instances: N |
| ambiente flessibile App Engine | manual_scaling: instances: N |
| Cloud Run | scalingMode: MANUALmanualInstanceCount: N |
Strategia di migrazione: esiste una mappatura diretta in Cloud Run per la scalabilità manuale. Imposta la modalità di scalabilità su MANUAL a livello di servizio in Cloud Run e specifica il numero esatto di istanze da eseguire utilizzando manualInstanceCount. Questo ha lo stesso effetto della disattivazione completa della scalabilità automatica. Per saperne di più, consulta Scalabilità manuale in Cloud Run.
Periodo di attesa
Configura un periodo di attesa dopo un evento di scale up prima che si verifichi un altro evento.
| Ambiente di configurazione | Impostazioni |
|---|---|
| ambiente standard App Engine | Non disponibile |
| ambiente flessibile App Engine | automatic_scaling:cool_down_period_sec: N |
| Cloud Run | Nessun equivalente diretto |
Strategia di migrazione: non richiesta. Cloud Run esegue la scalabilità automatica in base alla domanda e all'utilizzo ed è progettato per reagire in modo efficiente senza una configurazione manuale del periodo di attesa.
Richieste di warmup
Cloud Run esegue automaticamente il preriscaldamento delle istanze utilizzando il comando entrypoint del container, quindi non è necessario abilitare manualmente le richieste di warmup o configurare un gestore /_ah/warmup. Se hai un codice che vuoi eseguire all'avvio dell'istanza prima che vengano elaborate le richieste, puoi:
Contenuti statici
Nell'ambiente standard App Engine, puoi pubblicare contenuti statici senza utilizzare risorse di computing pubblicandoli da Cloud Storage o configurando gestori.Cloud Run non dispone dell'opzione dei gestori per la pubblicazione di contenuti statici, quindi puoi pubblicare i contenuti dal servizio Cloud Run (come per i contenuti dinamici) o da Cloud Storage.
Ruolo Cloud Run Invoker
Cloud Run offre anche la possibilità di controllare l'accesso a un servizio con Identity and Access Management (IAM). Le associazioni delle policy IAM per un servizio possono essere impostate utilizzando gcloud CLI, la console o Terraform.
Per replicare il comportamento di App Engine, puoi rendere pubblico il servizio consentendo le richieste non autenticate. Può essere impostato al momento del deployment o aggiornando le associazioni delle policy IAM su un servizio esistente.
Deployment
Utilizza il flag di deployment --allow-unauthenticated:
gcloud run deploy SERVICE_NAME ... --allow-unauthenticated
Servizio esistente
Utilizza il comando gcloud run services add-iam-policy-binding:
gcloud run services add-iam-policy-binding SERVICE_NAME \ --member="allUsers" \ --role="roles/run.invoker"
dove SERVICE_NAME è il nome del servizio Cloud Run.
In alternativa, puoi scegliere di controllare chi ha accesso al servizio concedendo il ruolo IAM Cloud Run Invoker, configurabile per servizio.
Deployment
gcloud run deploy SERVICE_NAME ... --no-allow-unauthenticated gcloud run services add-iam-policy-binding SERVICE_NAME \ --member=MEMBER_TYPE \ --role="roles/run.invoker"
dove SERVICE_NAME è il nome del servizio e MEMBER_TYPE è il tipo di entità. Ad esempio: user:email@domain.com.
Per un elenco dei valori accettabili per MEMBER_TYPE, consulta
Identificatori delle entità.
Servizio esistente
gcloud run services add-iam-policy-binding SERVICE_NAME \ --member=MEMBER_TYPE \ --role="roles/run.invoker"
dove SERVICE_NAME è il nome del servizio e MEMBER_TYPE è il tipo di entità. Ad esempio: user:email@domain.com.
Per un elenco dei valori accettabili per MEMBER_TYPE, consulta
Identificatori delle entità.
Variabili di ambiente e metadati
Sia App Engine che Cloud Run hanno alcune variabili di ambiente impostate automaticamente. La tabella seguente mostra le variabili di ambiente di App Engine e i relativi equivalenti di Cloud Run. Cloud Run implementa solo alcune variabili di ambiente rispetto ad App Engine, ma i dati disponibili dal server dei metadati sono per lo più equivalenti.
Variabili di ambiente predefinite
| Nome App Engine | Nome Cloud Run | Descrizione |
|---|---|---|
GAE_SERVICE
|
K_SERVICE
|
Il nome del servizio corrente. In App Engine, se non viene specificato, questo valore è impostato su "default". |
GAE_VERSION
|
K_REVISION
|
L'etichetta della versione attuale del servizio. |
PORT
|
PORT
|
La porta che riceve le richieste HTTP. |
| N/D | K_CONFIGURATION
|
Il nome della configurazione Cloud Run che ha creato la revisione. |
GOOGLE_CLOUD_PROJECT
|
N/D | L'ID progetto Google Cloud associato alla tua applicazione. |
GAE_APPLICATION
|
L'ID della tua applicazione App Engine. Questo ID è preceduto dal prefisso "codice regione~", ad esempio "e~" per le applicazioni di cui è stato eseguito il deployment in Europa. | |
GAE_DEPLOYMENT_ID
|
L'ID del deployment corrente. | |
GAE_ENV
|
L'ambiente App Engine. Impostalo su "standard" se ti trovi nell'ambiente standard. | |
GAE_INSTANCE
|
L'ID dell'istanza su cui è in esecuzione il servizio. | |
GAE_MEMORY_MB
|
La quantità di memoria disponibile per il processo dell'applicazione, in MB. | |
NODE_ENV (disponibile solo nel runtime Node.js)
|
Impostalo su Produzione quando viene eseguito il deployment del servizio. | |
GAE_RUNTIME
|
Il runtime specificato nel file app.yaml. |
Percorsi comuni del server di metadati
| Percorso | Descrizione | Esempio |
|---|---|---|
/computeMetadata/v1/project/project-id
|
ID progetto del progetto a cui appartiene il servizio | test_project |
/computeMetadata/v1/project/numeric-project-id
|
Numero di progetto del progetto a cui appartiene il servizio | 12345678912 |
/computeMetadata/v1/instance/id
|
Identificatore univoco dell'istanza del container (disponibile anche nei log). | 16a61494692b7432806a16
(stringa di caratteri alfanumerici) |
/computeMetadata/v1/instance/region
** Non disponibile per l'ambiente flessibile di App Engine |
Regione di questo servizio, restituisce projects/PROJECT_NUMBER/regions/REGION
|
projects/12345678912/regions/us-central1 |
/computeMetadata/v1/instance/service-accounts/default/email
|
Email per il account di servizio di runtime di questo servizio. | service_account@test_project.iam.gserviceaccount.com |
/computeMetadata/v1/instance/service-accounts/default/token
|
Genera un token di accesso OAuth2 per il account di servizio di questo servizio. Questo endpoint restituirà una risposta JSON con un attributo access_token.
|
{ "access_token":"<TOKEN>", "expires_in":1799, "token_type":"Bearer" } |
Passaggi successivi
- Guida rapida: esegui il deployment di un servizio web con Cloud Run
- La mia app è adatta a Cloud Run?
- Esegui la migrazione del mio dominio personalizzato App Engine a Cloud Load Balancing
- Altre risorse: