Esegui il deployment di un'app App Engine nell'ambiente standard su Cloud Run

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.

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

Cloud Run utilizza gran parte della stessa infrastruttura dell'ambiente standard di App Engine, il che comporta molte somiglianze tra le piattaforme. Per scoprire di più sulle somiglianze e 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 utilizzando il comando gcloud beta app migrate, scegli una delle seguenti strategie:

Prima di iniziare

  1. Assicurati di avere accesso al codice sorgente di App Engine e che l'applicazione App Engine venga eseguita senza errori.

  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 con l'ID progetto Google Cloud .
    • REGION con la tua regione.

  4. Esamina le funzionalità incompatibili nella tua applicazione e rimuovile prima di eseguire la migrazione a Cloud Run. Se nell'applicazione esistente sono presenti funzionalità incompatibili, il processo di migrazione si interrompe ed elenca le incompatibilità.

  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 su Cloud Run utilizzando gcloud CLI o la console Google Cloud per configurare e gestire le impostazioni dell'app. Cloud Run non richiede la configurazione basata su file, ma è supportata la configurazione YAML.

    • Ogni servizio di cui esegui il deployment su 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 App Engine. Tu o il tuo amministratore dovete concedere all'account di deployment e al account di servizio Cloud Build i seguenti ruoli IAM.

Fai clic per visualizzare i ruoli richiesti per l'account di deployment

Per ottenere le autorizzazioni necessarie per compilare 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 service account Cloud Build predefinito per creare il codice sorgente e la risorsa Cloud Run, a meno che tu non esegua 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 progetto Google Cloud. Per istruzioni dettagliate su come trovare l'ID progetto e il numero di progetto, vedi Creazione e gestione dei progetti.

La concessione del ruolo Cloud Run Builder al account di servizio Compute Engine predefinito richiede alcuni 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.

Utilizzare il file app.yaml

Traduci il file app.yaml di App Engine in un servizio Cloud Run eseguendo questo comando:

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

Sostituisci quanto segue:

  • PATH con il percorso del file app.yaml.
  • ENTRYPOINT con il comando del punto di ingresso per la tua applicazione.

Se ti trovi nella directory del progetto, entrambi gli argomenti PATH e ENTRYPOINT sono facoltativi.

Per ulteriori informazioni sugli argomenti che puoi utilizzare con il comando gcloud beta app migrate-to-run, consulta gcloud beta app migrate-to-run.

Eseguire il deployment di un'applicazione App Engine esistente

Esegui il deployment di un'app App Engine esistente direttamente su Cloud Run eseguendo il comando seguente:

gcloud beta app migrate-to-run --service=SERVICE --version=VERSION --entrypoint=ENTRYPOINT

Questo comando ti chiede di specificare il percorso relativo alla directory del codice sorgente.

Sostituisci quanto segue:

  • SERVICE con il nome del tuo servizio App Engine.
  • VERSION con l'ID versione del tuo servizio.
  • ENTRYPOINT con il comando del punto di ingresso per la tua applicazione. Se ti trovi nella directory del progetto, questo argomento è facoltativo.

Per ulteriori informazioni sugli argomenti che puoi utilizzare con il comando gcloud beta app migrate, consulta gcloud beta app migrate-to-run.

Funzionalità non compatibili

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

  • Pagine di errore personalizzate:

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

  • Servizi in bundle per i runtime di seconda generazione:

    app_engine_apis: true

  • Variabili di ambiente di build:

    build_env_variables:
  Foo: Bar

  • Runtime di prima generazione:

    runtime: python27

Passaggi successivi