Esegue il deployment delle applicazioni

Il deployment di una bozza di applicazione in App Design Center consente di eseguire il provisioning delle risorse Google Cloud e di registrare automaticamente l'applicazione in App Hub. Prima di eseguire il deployment, puoi visualizzare l'anteprima delle modifiche pianificate di Terraform, valutare il tuo progetto in base alle policy dell'organizzazione e abilitare le APIGoogle Cloud richieste. Dopo il deployment, puoi esaminare i problemi di deployment, analizzare le prestazioni delle risorse utilizzando i dati di telemetria e applicare nuove revisioni del template alla tua applicazione.

Prima di iniziare

Per eseguire le attività descritte in questo documento, chiedi all'amministratore di concederti i ruoli necessari per la cartella app o il progetto di gestione, come elencato nella tabella seguente:

Attività	Ruoli obbligatori
Esegui il deployment di un'applicazione e applica le revisioni dei template	Application Admin (roles/designcenter.applicationAdmin) o Application Operator (roles/designcenter.applicationOperator)
Crea automaticamente un account di servizio durante il deployment	Project IAM Admin (roles/resourcemanager.projectIamAdmin)

Per eseguire il deployment dell'applicazione utilizzando un account di servizio esistente, consulta Concedi ruoli al service account.

Per saperne di più sui ruoli, consulta Controllo dell'accesso con IAM.

Esegui il deployment dell'applicazione

Seleziona un'opzione del account di servizio ed esegui il deployment dell'applicazione. Quando esegui il deployment di un'applicazione, vengono create risorse Google Cloud e inizi a sostenere i costi associati a queste risorse.

Canvas di progettazione

1. Nel menu di navigazione, fai clic su Applicazioni.

   Vai a Applicazioni

2. Nella tabella, fai clic su Nome applicazione.

3. Nella pagina Dettagli applicazione, esamina i dettagli e fai clic su Modifica per apportare modifiche.

   Nota: se prevedi di eseguire il deployment e in seguito eliminare questa applicazione, esegui il deployment nell'ambiente TEST, DEVELOPMENT o STAGING.

4. Fai clic su Esegui il deployment.

5. Seleziona uno dei seguenti service account per eseguire il deployment della tua applicazione:

   • Seleziona un service account: nel campo Service account, inserisci il nome di un account di servizio esistente. Per configurare il service account, consulta Concedi i ruoli al service account.

   • Crea un nuovo service account: devi disporre del ruolo Project IAM Admin (roles/resourcemanager.projectIamAdmin), che viene utilizzato per assegnare i ruoli di deployment richiesti al account di servizio.

6. Fai clic su Procedi.

7. Per visualizzare l'anteprima delle modifiche che Terraform pianifica di apportare alla tua infrastruttura, segui questi passaggi:

   1. Fai clic su Anteprima.

   2. Rivedi le modifiche e fai clic su Copia e chiudi. L'anteprima viene copiata negli appunti.

   3. Per salvare l'anteprima, incollala e salvala in un documento a tua scelta.

8. Nell'area Esamina le API, esamina l'elenco delle API richieste per la tua applicazione. Le API vengono abilitate automaticamente quando esegui il deployment.

9. Fai clic su Esegui il deployment. I dettagli dell'applicazione e lo stato del deployment vengono visualizzati al termine del deployment.

10. Se si verificano problemi con il deployment, segui questi passaggi:

    1. Nel riquadro Dettagli applicazione, fai clic su Deployment.

    2. Esamina i messaggi di errore.

    3. Fai clic su Visualizza log per visualizzare informazioni dettagliate sulla build.

    4. Per visualizzare i suggerimenti per correggere gli errori di deployment, fai clic su Risolvi i problemi di deployment (Anteprima).

       Per saperne di più, consulta Risolvi i problemi di deployment.

    Suggerimento: per visualizzare un elenco di applicazioni con problemi di deployment in Cloud Hub, consulta Visualizza i deployment.

11. Per gestire l'applicazione di cui hai eseguito il deployment, consulta Visualizza i dettagli dell'applicazione.

gcloud CLI

1. Visualizza l'anteprima dell'applicazione per visualizzare il codice Terraform prima di eseguire il deployment. Il completamento di questa operazione potrebbe richiedere diversi minuti. Esegui una delle seguenti operazioni:

   • Per creare automaticamente un account di servizio, utilizza il seguente comando:

     gcloud design-center spaces applications preview APPLICATION \
     --project=PROJECT \
     --location=LOCATION \
     --space=SPACE \
     --create-sa \
     --service-account=SERVICE_ACCOUNT
     

   • Per utilizzare il tuo account di servizio, utilizza il seguente comando:

     gcloud design-center spaces applications preview APPLICATION \
     --project=PROJECT \
     --location=LOCATION \
     --space=SPACE \
     --service-account=SERVICE_ACCOUNT
     

   Sostituisci quanto segue:

   • APPLICATION: l'ID applicazione.
   • PROJECT: l'ID del tuo progetto di gestione.
   • LOCATION: la regione dell'applicazione.
   • SPACE: l'ID dello spazio.
   • SERVICE_ACCOUNT: esegui una delle seguenti operazioni:
     • Per creare un nuovo account di servizio, fornisci un nome per il account di servizio.
     • Per utilizzare il tuo account di servizio, fornisci il nome completo della risorsa nel formato projects/PROJECT/serviceAccounts/EMAIL_ADDRESS.

   Per saperne di più, consulta gcloud design-center spaces applications preview.

2. Esegui il deployment dell'applicazione in modo asincrono e copia il nome completo dell'operazione. Esegui una delle seguenti operazioni:

   Nota: per aggiornare un'applicazione esistente, aggiungi il flag --replace ai seguenti comandi di deployment.

   • Per creare automaticamente un account di servizio, utilizza il seguente comando:

      gcloud design-center spaces applications deploy APPLICATION \
      --project=PROJECT \
      --location=LOCATION \
      --space=SPACE \
      --create-sa \
      --service-account=SERVICE_ACCOUNT \
      --async
     

   • Per utilizzare il tuo account di servizio, utilizza il seguente comando:

      gcloud design-center spaces applications deploy APPLICATION \
      --project=PROJECT \
      --location=LOCATION \
      --space=SPACE \
      --service-account=SERVICE_ACCOUNT \
      --async
     

   Sostituisci quanto segue:

   • APPLICATION: l'ID applicazione.
   • PROJECT: l'ID del tuo progetto di gestione.
   • LOCATION: la regione dell'applicazione.
   • SPACE: l'ID dello spazio.
   • SERVICE_ACCOUNT: esegui una delle seguenti operazioni:
     • Per creare un nuovo account di servizio, fornisci un nome per il account di servizio.
     • Per utilizzare il tuo account di servizio, fornisci il nome completo della risorsa nel formato projects/PROJECT/serviceAccounts/EMAIL_ADDRESS.

   Per saperne di più, consulta gcloud design-center spaces applications deploy.

3. Il deployment richiede alcuni minuti. Monitora lo stato del deployment.

   gcloud design-center operations describe OPERATION\
   --project=PROJECT \
   --location=LOCATION
   

   Sostituisci quanto segue:

   • OPERATION: il nome completo dell'operazione copiato dall'output comando deploy nel formato projects/PROJECT/locations/LOCATION/operations/operation-<var>OPERATION_ID</var>.
   • PROJECT: l'ID del tuo progetto di gestione.
   • LOCATION: la regione dell'applicazione.

   Per saperne di più, consulta gcloud design-center operations describe.

Risolvi i problemi di deployment

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Se il deployment dell'applicazione non va a buon fine, puoi visualizzare un riepilogo degli errori, ottenere un'analisi dettagliata, identificare i passaggi per la risoluzione e risolvere automaticamente alcuni problemi.

Per risolvere i problemi e correggere gli errori:

1. Nel riquadro Dettagli applicazione, fai clic su Deployment.

2. Per analizzare gli errori e suggerire correzioni, fai clic su Risolvi i problemi di deployment.

   Il riquadro Dettagli per la risoluzione dei problemi mostra suggerimenti sulla documentazione, modifiche alla configurazione e altre informazioni che possono aiutarti a risolvere gli errori di deployment.

3. Esamina gli errori e i suggerimenti relativi al deployment:

   1. Se l'analisi genera suggerimenti per le configurazioni dei componenti, esamina le modifiche suggerite e fai clic su Aggiorna applicazione per applicarle.

   2. Se l'analisi genera altri suggerimenti, il sistema visualizza i comandi gcloud CLI che puoi eseguire per risolvere gli errori. Per eseguire i comandi gcloud CLI in Cloud Shell, fai clic su Esegui comando.

Visualizza i dettagli dell'applicazione

Al termine del deployment dell'applicazione, puoi esaminare le informazioni correlate. Ad esempio, potresti visualizzare quanto segue:

• Dettagli come l'ora dell'ultimo aggiornamento, la data di revisione e la regione.
• Output come l'URI del servizio.
• Stato del deployment, informazioni sugli errori e link ai log.

Per visualizzare i dettagli dell'applicazione:

Canvas di progettazione

1. Nel menu di navigazione, fai clic su Applicazioni.

   Vai a Applicazioni

2. Nella tabella, fai clic su Nome applicazione. Il riquadro Dettagli applicazione mostra quanto segue:

   • Visualizza app in App Hub: esamina la tua applicazione in App Hub. Puoi visualizzare le risorse di cui è stato eseguito il deployment ed esaminare i dati di telemetria per diagnosticare i problemi e analizzare le prestazioni. Per saperne di più, consulta Monitora le applicazioni App Hub.

   • Dettagli sull'app: visualizza informazioni come la data dell'ultimo aggiornamento, il modello di origine, la regione e l'account di servizio.

   • Output: identifica gli URI del servizio, che puoi utilizzare per interagire con il frontend o il backend dell'applicazione.

   • Deployment: esamina lo stato del deployment, gli errori di deployment e i link ai log per risolvere gli errori.

gcloud CLI

gcloud design-center spaces applications describe APPLICATION \
--project=PROJECT \
--location=LOCATION \
--space=SPACE

Sostituisci quanto segue:

• APPLICATION: l'ID applicazione.
• PROJECT: l'ID del tuo progetto di gestione.
• LOCATION: la regione dell'applicazione.
• SPACE: l'ID dello spazio.

Per saperne di più, consulta gcloud design-center spaces applications describe.

Modifica le applicazioni di cui è stato eseguito il deployment

Se vuoi modificare un'applicazione di cui è stato eseguito il deployment, segui uno di questi passaggi per assicurarti che le modifiche vengano mantenute quando rifai il deployment dell'applicazione:

• Modifica il template e poi applica la revisione del template
• Rivedi la richiesta

Applica le revisioni del template

Se in precedenza è stato eseguito il deployment della tua applicazione utilizzando Application Design Center e un amministratore ha condiviso con te una revisione del template, puoi applicare le modifiche del template alla tua applicazione. Quando aggiorni l'applicazione, viene creata una revisione dell'applicazione. Puoi configurare i componenti che sono stati modificati o aggiunti al modello rivisto.

Puoi visualizzare le revisioni dei modelli disponibili per le tue applicazioni utilizzando Cloud Hub. Per saperne di più, consulta Visualizza i deployment.

Per applicare le revisioni del modello alla tua applicazione:

Attenzione: se hai modificato i componenti di un'applicazione al di fuori di App Design Center, queste modifiche non vengono conservate quando rifai il deployment. Per conservare le modifiche, consulta Modifica le applicazioni di cui è stato eseguito il deployment.

Canvas di progettazione

1. Nel menu di navigazione, fai clic su Modelli.

   Vai ai Modelli

2. Fai clic sull'ID template che contiene la revisione che vuoi applicare.

3. Dall'elenco Configura un'app, seleziona l'applicazione che vuoi aggiornare.

4. Modifica i dettagli dell'applicazione e fai clic su Salva.

5. Fai clic su ciascun componente nel canvas di progettazione e modifica le configurazioni dei componenti.

6. Fai clic su Esegui il deployment. Per i passaggi di deployment, consulta Esegui il deployment dell'applicazione.

gcloud CLI

1. Identifica l'URI della revisione del template dell'applicazione per l'ultima revisione.

    gcloud design-center spaces application-templates describe APPLICATION_TEMPLATE \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE \
    --format='yaml(name,latestRevision)'
   

   Sostituisci quanto segue:

   • APPLICATION_TEMPLATE: l'ID del template di applicazione su cui si basa l'applicazione.
   • PROJECT: l'ID del tuo progetto di gestione.
   • LOCATION: la regione del template dell'applicazione.
   • SPACE: l'ID dello spazio.

   Per saperne di più, consulta gcloud design-center spaces application-templates describe.

2. Copia l'output latestRevision.

3. Aggiorna l'applicazione in modo che utilizzi la revisione del template dell'applicazione.

    gcloud design-center spaces applications update APPLICATION \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE \
    --source-application-template-revision=SOURCE_APPLICATION_TEMPLATE_REVISION
   

   Sostituisci quanto segue:

   • APPLICATION: l'ID applicazione.
   • PROJECT: l'ID del tuo progetto di gestione.
   • LOCATION: la regione dell'applicazione.
   • SPACE: l'ID dello spazio.
   • SOURCE_APPLICATION_TEMPLATE_REVISION: l'URI del template dell'applicazione. Ad esempio, projects/PROJECT/locations/LOCATION/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/revisions/REVISION

   Per saperne di più, consulta gcloud design-center spaces applications update.

4. Per configurare componenti nuovi o aggiornati nell'applicazione, consulta Configura componenti e connessioni.

5. Quando esegui il deployment dell'applicazione, utilizza il flag --replace. Per i passaggi di deployment, consulta Esegui il deployment dell'applicazione.

Passaggi successivi

• Tieni traccia dei tuoi workload monitorando l'integrità e le prestazioni delle applicazioni.
• Inizia a utilizzare le architetture preconfigurate basandoti sui modelli di Google.