Esegui il deployment di un'app App Engine nell'ambiente standard su 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 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.

Questa guida descrive come eseguire il deployment delle app esistenti nell'ambiente standard in Cloud Run. Le istruzioni sono applicabili ai runtime di seconda generazione che non utilizzano i servizi in bundle legacy di App Engine.

I passaggi descritti in questa guida non influiscono sulla funzionalità o sul flusso di traffico dell'app App Engine esistente. Il servizio Cloud Run appena creato è una replica del servizio App Engine che puoi testare in modo indipendente.

Cloud Run utilizza gran parte della stessa infrastruttura dell'ambiente standard App Engine, il che si traduce in molte somiglianze tra le piattaforme. Per scoprire di più sulle somiglianze e sulle differenze tra App Engine e Cloud Run, inclusi i vantaggi della migrazione a Cloud Run, consulta il riepilogo del confronto.

Per eseguire il deployment in Cloud Run, scegli una delle seguenti strategie:

  • Utilizza la configurazione locale di un file app.yaml (consigliato): scegli questa opzione per creare un'immagine container direttamente dal codice sorgente locale ed eseguirne il deployment in Cloud Run. In questo modo, tutte le modifiche locali recenti al codice o alla configurazione vengono incluse nel nuovo deployment.

  • Utilizza un'immagine creata in precedenza: questa opzione è utile se non hai accesso al codice sorgente. Scegli questa opzione per eseguire il deployment di una copia esatta di una versione già in esecuzione su App Engine, senza ricreare l'immagine container. Questo è utile se vuoi verificare il comportamento del deployment attivo senza modifiche al codice.

Prima di iniziare

  1. Assicurati che l'applicazione App Engine venga eseguita senza errori. Se scegli di eseguire il deployment utilizzando la configurazione locale, devi avere accesso al codice sorgente di App Engine.

  2. Abilita l'API Cloud Run Admin e l'API Artifact Registry:

    Abilita le API

  3. Configura il progetto e la regione utilizzando il seguente comando:

    gcloud auth login
gcloud config set project PROJECT_ID
gcloud config set run/region REGION
gcloud components update

    Sostituisci quanto segue:

    • PROJECT_ID: il tuo ID progetto Google Cloud .
    • REGION: la regione in cui vuoi eseguire il deployment del servizio Cloud Run.

  4. Verifica la presenza di funzionalità incompatibili nella tua applicazione e rimuovile prima di eseguire la migrazione a Cloud Run. Per verificare l'incompatibilità della tua applicazione senza eseguire una migrazione o un deployment, esegui questo comando:

    gcloud beta app migrate-to-run --dry-run

    Esamina i risultati del controllo di compatibilità e apporta le modifiche consigliate, se necessario.

  5. Esamina le seguenti differenze di Cloud Run:

    • Cloud Run utilizza il termine Revision, anziché Version, per rappresentare ogni volta che esegui il deployment delle modifiche a un servizio specifico. Eseguendo il deployment della tua app in un servizio in Cloud Run per la prima volta viene creata la prima revisione. Ogni deployment successivo di un servizio crea un'altra revisione. Scopri di più sul deployment in Cloud Run.

    • Puoi eseguire il deployment del codice sorgente in Cloud Run utilizzando gcloud CLI o la console Google Cloud per configurare e gestire le impostazioni dell'app. Cloud Run non richiede una configurazione basata su file, ma supporta la configurazione YAML.

    • Ogni servizio di cui esegui il deployment in Cloud Run utilizza il dominio run.app nell'URL per accedere pubblicamente al servizio.

    • A differenza dei servizi App Engine, che sono pubblici per impostazione predefinita, i servizi Cloud Run sono privati per impostazione predefinita e richiedono la configurazione per l'accesso pubblico (non autenticato).

Ruoli obbligatori

Puoi scegliere di creare un nuovo account di servizio o di utilizzare lo stesso account di servizio gestito dall'utente in Cloud Run che utilizzi per l'ambiente standard. Tu o il tuo amministratore dovete concedere all'account deployer e al account di servizio Cloud Build i seguenti ruoli IAM.

Fai clic per visualizzare i ruoli richiesti per l'account deployer

Per ottenere le autorizzazioni necessarie per creare ed eseguire il deployment dal codice sorgente, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Fai clic per visualizzare i ruoli richiesti per il account di servizio Cloud Build

Cloud Build utilizza automaticamente l'account di servizio predefinito di Compute Engine come account di servizio Cloud Build predefinito per creare il codice sorgente e la risorsa Cloud Run, a meno che non esegui l'override di questo comportamento. Per consentire a Cloud Build di creare le tue origini, chiedi all'amministratore di concedere il ruolo Cloud Run Builder (roles/run.builder) al account di servizio Compute Engine predefinito nel tuo progetto:

  gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com \
      --role=roles/run.builder

Sostituisci PROJECT_NUMBER con il numero del tuo progetto Google Cloude PROJECT_ID con l'ID del tuo progetto Google Cloud. Per istruzioni dettagliate su come trovare l'ID progetto e il numero di progetto, consulta Creazione e gestione dei progetti.

La concessione del ruolo Cloud Run Builder al account di servizio predefinito di Compute Engine richiede un paio di minuti per la propagazione.

Per un elenco di ruoli e autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM di Cloud Run e Autorizzazioni IAM di Cloud Run. Se il tuo servizio Cloud Run interagisce con le APIGoogle Cloud , come le librerie client Cloud, consulta la guida alla configurazione dell'identità del servizio. Per saperne di più sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestisci l'accesso.

Utilizza la configurazione locale di un file app.yaml

Esegui il deployment della configurazione App Engine locale in Cloud Run utilizzando la console Google Cloud o gcloud CLI.

Console

  1. Nella console Google Cloud , vai alla pagina App Engine.

    Vai ad App Engine

  2. Nel menu di navigazione, fai clic su Hub di migrazione per eseguire il deployment dell'app App Engine in Cloud Run. L'hub di migrazione ti consente anche di controllare i risparmi stimati su Cloud Run per la stima dei costi e i suggerimenti.

  3. Seleziona il servizio di cui vuoi eseguire la migrazione e fai clic su Verifica compatibilità.

  4. Seleziona il Servizio e la Versione per visualizzare i risultati di compatibilità. L'hub di migrazione esegue uno strumento di verifica della compatibilità per identificare le funzionalità incompatibili.

  5. Esamina i risultati per verificare che la tua app sia completamente compatibile con Cloud Run e fai clic su Continua per andare alla sezione Rivedi ed esegui il deployment.

  6. Copia il comando nella sezione Esegui il deployment tramite gcloud ed eseguilo nella directory del progetto.

  7. Fai clic su Visualizza le versioni di cui è stato eseguito il deployment per visualizzare i servizi App Engine di cui è stato eseguito il deployment in Cloud Run.

gcloud

Per eseguire il deployment del servizio Cloud Run utilizzando il file app.yaml locale di una configurazione App Engine esistente, segui questi passaggi:

  1. Nel terminale, passa alla directory di origine in cui si trova il file app.yaml.

  2. Esegui questo comando per eseguire il deployment del servizio in Cloud Run:

    gcloud beta app migrate-to-run

    Questo comando genera la configurazione del file service.yaml per Cloud Run e la salva localmente nella stessa directory del file app.yaml. Per saperne di più, consulta gcloud beta app migrate-to-run.

    • Quando richiesto Proceed with the deployment?, inserisci Y per creare un'immagine container dal codice sorgente ed eseguire il deployment del servizio in Cloud Run.

  3. Visita il servizio Cloud Run di cui hai eseguito il deployment aprendo l'URL del servizio in un browser web.

    Facoltativamente,

    • Se il file app.yaml si trova in una directory diversa, specifica il percorso utilizzando il flag --appyaml:

      gcloud beta app migrate-to-run --appyaml=PATH

      Sostituisci PATH con il percorso del file app.yaml.

    • Per generare ed esportare la configurazione di Cloud Run service.yaml senza eseguire il deployment del servizio, utilizza il flag --export-only:

      gcloud beta app migrate-to-run --export-only=EXPORT_PATH

      Sostituisci EXPORT_PATH con la directory o il percorso in cui vuoi salvare il file service.yaml.

Utilizza un'immagine creata in precedenza

Per eseguire il deployment utilizzando un'immagine container creata in precedenza da una versione di App Engine di cui è stato eseguito il deployment anziché ricreare l'immagine container da un file app.yaml locale, segui questi passaggi:

Per questo deployment non è necessario il codice sorgente dell'applicazione.

  1. Esegui questo comando per eseguire il deployment del servizio in Cloud Run. Questo comando utilizza l'immagine container di un deployment App Engine attivo e non acquisisce le modifiche recenti dal file app.yaml locale, il che potrebbe comportare un deployment obsoleto:

    gcloud beta app migrate-to-run --service=SERVICE --version=VERSION --from-image

    Sostituisci quanto segue:

    • SERVICE: il nome del tuo servizio App Engine.
    • VERSION: l'ID versione del servizio.

    Questo comando recupera la configurazione del servizio e della versione specificati per generare il file service.yaml per Cloud Run. Per saperne di più, consulta gcloud beta app migrate-to-run.

    • Quando viene visualizzato il prompt Proceed with the deployment?, inserisci Y per esportare l'immagine container App Engine esistente ed eseguire il deployment del servizio in Cloud Run.

  2. Visita il servizio Cloud Run di cui hai eseguito il deployment aprendo l'URL del servizio in un browser web.

    Facoltativamente,

    • Per generare la configurazione di Cloud Run service.yaml senza eseguire il deployment del servizio, esegui questo comando:

      gcloud beta app migrate-to-run --service=SERVICE \
    --version=VERSION \
    --from-image \
    --export-only=EXPORT_PATH

      Sostituisci EXPORT_PATH con la directory o il percorso in cui vuoi salvare il file service.yaml.

Funzionalità incompatibili

Il comando di migrazione non va a buon fine se il file app.yaml contiene una delle seguenti configurazioni non supportate:

  • Servizi in entrata:

    inbound_services:
- warmup

    Soluzione: elimina la sezione inbound_services dal file app.yaml. Cloud Run prepara le istanze utilizzando l'entrypoint del container, quindi non è necessario configurare le richieste di warmup. Se devi eseguire il codice di inizializzazione prima di gestire il traffico, configura il servizio in modo che lo esegua all'avvio, prima di ascoltare le richieste o utilizza i probe di avvio. Puoi anche configurare un numero minimo di istanze per mantenerle attive.

  • Pagine di errore personalizzate:

    error_handlers:
 - file: default_error.html
 - error_code: over_quota
 file: over_quota.html

    Soluzione: elimina la sezione error_handlers dal file app.yaml e segui una o entrambe queste strategie:

    • Implementa la gestione degli errori direttamente nel codice dell'applicazione. Intercetta i codici di errore HTTP standard, come 404 o 500, e pubblica le tue pagine di errore HTML personalizzate dalla logica dell'applicazione.
    • Se utilizzi Cloud Load Balancing con Cloud Run, configura risposte di errore personalizzate a livello di bilanciatore del carico. In questo modo puoi pubblicare pagine di errore personalizzate da Cloud Storage in base al codice di risposta del servizio Cloud Run.

  • app_engine_apis: true

    Soluzione: elimina l'impostazione app_engine_apis dal file app.yaml ed esegui la migrazione alle API Google Cloud o ad alternative di terze parti. Per saperne di più, consulta Migrazione dai servizi in bundle.

  • Runtime di prima generazione:

    runtime: python27

    Soluzione: esegui l'upgrade dell'applicazione a un runtime di seconda generazione supportato. Per saperne di più, consulta la panoramica della migrazione ai runtime di seconda generazione.

Passaggi successivi