Deployment in App Engine

Questa pagina spiega come eseguire il deployment delle applicazioni in App Engine utilizzando Cloud Build. Se non hai mai utilizzato Cloud Build, leggi prima gli avvii rapidi e la panoramica della configurazione di compilazione.

App Engine è una piattaforma serverless completamente gestita per lo sviluppo e l'hosting di applicazioni web su larga scala. Per ulteriori informazioni su App Engine, consulta la documentazione di App Engine.

Prima di iniziare

  • Abilita l'API App Engine:

    Abilita l'API App Engine

  • Per eseguire i comandi gcloud in questa pagina, installa Google Cloud CLI.

  • Tieni a portata di mano il codice sorgente dell'applicazione che vuoi compilare ed eseguire in App Engine. Il codice sorgente deve essere archiviato in un repository, ad esempio Cloud Source Repositories, GitHub o Bitbucket.

Autorizzazioni IAM richieste

  1. Nella console Google Cloud, seleziona il progetto.

  2. Concedi il ruolo Account di servizio Cloud Build all'account di servizio predefinito App Engine. Se l'account di servizio non compare nell'elenco, individualo nella pagina Account di servizio.

    Vai ad Account di servizio

  3. Concedi il ruolo Amministratore App Engine e Utente account di servizio all'account di servizio di compilazione:

    1. Apri la pagina Impostazioni Cloud Build:

      Apri la pagina Impostazioni di Cloud Build

    2. Imposta lo stato del ruolo Amministratore App Engine e del ruolo Utente account di servizio su Attivato.

Configurazione del deployment

Cloud Build ti consente di utilizzare qualsiasi immagine container disponibile pubblicamente per eseguire le tue attività. A questo scopo, specifica l'immagine in un file step di compilazione nel file di configurazione di Cloud Build.

App Engine fornisce il comando gcloud app deploy, che crea un'immagine con il codice sorgente e la esegue su App Engine. Puoi utilizzare cloud-sdk image come passaggio di compilazione nel file di configurazione per richiamare i comandi gcloud all'interno dell'immagine. Gli argomenti passati a questo passaggio di compilazione vengono passati direttamente alla CLI gcloud, consentendoti di eseguire qualsiasi comando gcloud in questa immagine.

Per eseguire il deployment di un'applicazione in App Engine, segui questi passaggi:

  1. Crea un file di configurazione di Cloud Build chiamato cloudbuild.yaml o cloudbuild.json.

  2. Nel file di configurazione:

    • Aggiungi un campo name per specificare il passaggio di compilazione cloud-sdk.
    • Aggiungi un campo entrypoint per utilizzare lo strumento bash quando viene invocato cloud-sdk.
    • Nel campo args, invoca il comando gcloud app deploy e imposta un timeout per App Engine da utilizzare quando invoca Cloud Build. Questo è necessario perché i passaggi di compilazione e le build di Cloud Build hanno un timeout predefinito di 10 minuti e il completamento dei deployment di App Engine potrebbe richiedere più tempo. Se specifichi un timeout più lungo, la build non scadrà se gcloud app deploy richiede più di 10 minuti per essere completata.

      Errori di timeout quando si utilizza l'ambiente standard di App Engine: puoi configurare i timeout come descritto qui solo quando utilizzi l'ambiente flessibile di App Engine. L'ambiente standard di App Engine non consente di configurare il timeout di compilazione. Se utilizzi Cloud Build per il deployment nell'ambiente standard di App Engine e la compilazione non va a buon fine a causa di un errore di timeout, ti consigliamo di utilizzare l'ambiente flessibile di App Engine o Cloud Run anziché l'ambiente standard di App Engine.

    • Aggiungi un valore build timeout superiore a 10 minuti.

    YAML

    steps:
    - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
      entrypoint: 'bash'
      args: ['-c', 'gcloud config set app/cloud_build_timeout 1600 && gcloud app deploy']
    timeout: '1600s'
    

    JSON

    {
      "steps": [
      {
        "name": "gcr.io/google.com/cloudsdktool/cloud-sdk",
        "entrypoint": "bash",
        "args": [
          "-c",
          "gcloud config set app/cloud_build_timeout 1600 && gcloud app deploy"
         ]
      }
      ],
      "timeout": "1600s"
    }
    
  3. Avvia la compilazione, dove SOURCE_DIRECTORY è il percorso o l'URL del codice sorgente e REGION è una delle regioni di compilazione supportate per avviare la compilazione:

     gcloud builds submit --region=REGION SOURCE_DIRECTORY
    

Deployment continuo

Puoi automatizzare il deployment del software in App Engine creando trigger di Cloud Build. Puoi configurare i trigger per creare la build ed eseguire il deployment delle immagini ogni volta che aggiorni il codice sorgente.

Per automatizzare il deployment in App Engine:

  1. Nel repository, aggiungi un file di configurazione con i passaggi per richiamare il comando gcloud app deploy:

    YAML

    steps:
    - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
      entrypoint: 'bash'
      args: ['-c', 'gcloud config set app/cloud_build_timeout 1600 && gcloud app deploy']
    timeout: '1600s'
    

    JSON

    {
      "steps": [
      {
        "name": "gcr.io/google.com/cloudsdktool/cloud-sdk",
        "entrypoint": "bash",
        "args": [
          "-c",
          "gcloud config set app/cloud_build_timeout 1600 && gcloud app deploy"
         ]
      }
      ],
      "timeout": "1600s"
    }
    
  2. Crea un attivatore di build con il file di configurazione creato nel passaggio precedente:

    1. Apri la pagina Trigger nella console Google Cloud:

      Apri la pagina Trigger

    2. Seleziona il progetto dal menu a discesa del selettore progetti nella parte superiore della pagina.

    3. Fai clic su Apri.

    4. Fai clic su Crea trigger.

      Nella pagina Crea trigger, inserisci le seguenti impostazioni:

      1. Inserisci un nome per l'attivatore.

      2. Seleziona l'evento del repository per avviare l'attivatore.

      3. Seleziona il repository contenente il codice sorgente e il file di configurazione della build.

      4. Specifica la regex per il nome del ramo o del tag che attiverà l'attivatore.

      5. Configurazione: scegli il file di configurazione della build creato in precedenza.

    5. Fai clic su Crea per salvare il trigger di build.

Ogni volta che esegui il push di nuovo codice nel repository, avvii automaticamente una build e il deployment su App Engine.

Per ulteriori informazioni sulla creazione di trigger Cloud Build, consulta Creare e gestire gli trigger di build.

Passaggi successivi