Confronta App Engine e Cloud Run

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
  • https://SERVICE_NAME-PROJECT_NUMBER.REGION.run.app
  • https://SERVICE_IDENTIFIER.run.app
URL della versione/revisione https://VERSION-dot-SERVICE-dot-PROJECT_ID.REGION_ID.r.appspot.com
  • https://TAG---SERVICE_NAME-PROJECT_NUMBER.REGION.run.app
  • https://TAG---SERVICE_IDENTIFIER.run.app

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
  • Scalabilità automatica: 10 minuti
  • Scalabilità manuale/di base: 24 ore
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
Classe istanza vCPU* Memoria
F/B1 ,25 384 MB
F/B2 0,75 768 MB
F/B4 1 1,5 GB
F/B4_1G 1 3 GB
B8 2 3 GB
* Gli equivalenti vCPU sono approssimativi
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 $
  • vCPU: 0,0526 $
  • Memoria: 0,0071 $
    • vCPU: 0,0648 $
    • Memoria: 0,0072 $

    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

    Diagramma del modello di risorse di App Engine e Cloud Run

    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 default corrispondente.
    • È 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, dove REVISION_SUFFIX viene 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.app e https://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:
    instance_class: F1
    ..
    ..

    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
    • Scalabilità automatica: 10 minuti
    • Scalabilità manuale/di base: 24 ore
    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:

    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: MANUAL
      manualInstanceCount: 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