Esegue il deployment delle applicazioni

Dopo aver creato una bozza di applicazione da un modello, puoi eseguire il deployment dell'applicazione. Quando esegui il deployment di un'applicazione utilizzando App Design Center, l'applicazione viene registrata automaticamente in App Hub. La procedura di deployment ti consente di:

• Visualizzare in anteprima le modifiche che Terraform prevede di apportare alla tua infrastruttura.
• Abilitare le API delle risorse richieste per l'applicazione. Google Cloud
• Esaminare i problemi di deployment.
• Utilizzare i dati di telemetria per analizzare il rendimento delle risorse.
• Identificare e applicare le revisioni dei modelli all'applicazione.

Questo documento ti aiuta a eseguire il deployment, gestire e applicare una revisione del modello alla tua applicazione.

Prima di iniziare

Devi disporre di uno dei seguenti ruoli nella cartella o nel progetto di gestione abilitato per le app:

• Amministratore applicazioni (roles/designcenter.applicationAdmin)
• Operatore applicazioni (roles/designcenter.applicationOperator)

Per eseguire il deployment dell'applicazione con un service account, devi disporre di uno dei seguenti elementi:

• Il tuo account di servizio configurato per eseguire il deployment delle applicazioni e delle risorse sottostanti. Per ulteriori informazioni, vedi Concedere ruoli al service account.
• Il ruolo Amministratore IAM progetto (roles/resourcemanager.projectIamAdmin) nella cartella app. Questo ruolo ti consente di creare un nuovo account di servizio durante il deployment.

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, Google Cloud vengono create le risorse e inizi a sostenere i costi associati a queste risorse.

Canvas di progettazione

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

   Vai a Applicazioni

2. Nella tabella, fai clic sul nome dell'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 poi 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 dell'applicazione:

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

   • Crea un nuovo service account: devi disporre del ruolo Amministratore IAM progetto (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 in anteprima le modifiche che Terraform prevede di apportare alla tua infrastruttura:

   1. Fai clic su Anteprima.

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

   3. Per salvare l'anteprima, incolla e salva in un documento a tua scelta.

8. Nell'area Esamina API, esamina l'elenco delle API richieste per l'applicazione. Le API vengono abilitate automaticamente durante il deployment.

9. Fai clic su Esegui il deployment. Al termine del deployment, vengono visualizzati i dettagli dell'applicazione e lo stato del deployment.

10. Se si verificano problemi con il deployment:

    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 ulteriori informazioni, vedi Risolvere i problemi di deployment.

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

11. Per gestire l'applicazione di cui hai eseguito il deployment, vedi Visualizzare 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 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 ulteriori informazioni, vedi 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 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 ulteriori informazioni, vedi gcloud design-center spaces applications deploy.

3. Il completamento del 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 da l'output comando deploy nel formato projects/PROJECT/locations/LOCATION/operations/operation-<var>OPERATION_ID</var>.
   • PROJECT: l'ID progetto di gestione.
   • LOCATION: la regione dell'applicazione.

   Per ulteriori informazioni, vedi gcloud design-center operations describe.

Risolvere 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 riesce, puoi visualizzare un riepilogo degli errori, ottenere un'analisi dettagliata, identificare i passaggi per risolvere il problema e correggere 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 risoluzione dei problemi mostra suggerimenti di documentazione, modifiche alla configurazione e altre informazioni che possono aiutarti a risolvere gli errori di deployment.

3. Esamina gli errori e i suggerimenti di 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 della gcloud CLI che puoi eseguire per risolvere gli errori. Per eseguire i comandi della gcloud CLI in Cloud Shell, fai clic su Esegui comando.

Visualizzare 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 della 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. Dal menu di navigazione, fai clic su Applicazioni.

   Vai a Applicazioni

2. Nella tabella, fai clic sul nome dell'applicazione. Il riquadro Dettagli applicazione mostra quanto segue:

   • Visualizza app in App Hub: esamina l'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 il rendimento. Per ulteriori informazioni, vedi Monitorare le applicazioni App Hub.

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

   • Output: identifica gli URI dei servizi, 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 i problemi.

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 progetto di gestione.
• LOCATION: la regione dell'applicazione.
• SPACE: l'ID dello spazio.

Per ulteriori informazioni, vedi gcloud design-center spaces applications describe.

Modificare le applicazioni di cui è stato eseguito il deployment

Se vuoi modificare un'applicazione di cui è stato eseguito il deployment, esegui una delle seguenti operazioni per assicurarti che le modifiche vengano mantenute quando riesegui il deployment dell'applicazione:

• Modifica il modello e poi applica la revisione del modello
• Modifica l'applicazione

Applicare le revisioni dei modelli

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

Puoi visualizzare le revisioni dei modelli disponibili per le tue applicazioni utilizzando Cloud Hub. Per ulteriori informazioni, vedi Visualizzare i deployment.

Per applicare le revisioni dei modelli all'applicazione:

Attenzione: se hai modificato i componenti di un'applicazione al di fuori di App Design Center, queste modifiche non vengono mantenute quando esegui nuovamente il deployment. Per conservare le modifiche, vedi Modificare le applicazioni di cui è stato eseguito il deployment.

Canvas di progettazione

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

   Vai ai Modelli

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

3. Nell'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 ogni componente nel canvas di progettazione e modifica le configurazioni dei componenti.

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

Gcloud CLI

1. Identifica l'URI della revisione del modello di applicazione per la revisione più recente.

    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 modello di applicazione che è la base dell'applicazione.
   • PROJECT: l'ID progetto di gestione.
   • LOCATION: la regione del modello di applicazione.
   • SPACE: l'ID dello spazio.

   Per ulteriori informazioni, vedi gcloud design-center spaces application-templates describe.

2. Copia l'output latestRevision.

3. Aggiorna l'applicazione in modo che utilizzi la revisione del modello di 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 progetto di gestione.
   • LOCATION: la regione dell'applicazione.
   • SPACE: l'ID dello spazio.
   • SOURCE_APPLICATION_TEMPLATE_REVISION: l'URI del modello di applicazione. Ad esempio, projects/PROJECT/locations/LOCATION/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/revisions/REVISION

   Per ulteriori informazioni, vedi gcloud design-center spaces applications update.

4. Per configurare i componenti nuovi o aggiornati nell'applicazione, vedi Configurare componenti e connessioni.

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