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. Il processo di deployment ti consente di:

  • Visualizza in anteprima le modifiche che Terraform prevede di apportare alla tua infrastruttura.
  • Abilita le API Google Cloud delle risorse richieste per la tua applicazione.
  • Esamina i problemi di deployment.
  • Utilizza i dati di telemetria per analizzare il rendimento delle risorse.
  • Identifica e applica le revisioni dei modelli alla tua applicazione.

Questo documento ti aiuta a eseguire il deployment, la gestione e l'applicazione di una revisione del modello alla tua applicazione.

Prima di iniziare

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

  • Application Admin (roles/designcenter.applicationAdmin)
  • Operatore dell'applicazione (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 che hai configurato per eseguire il deployment delle applicazioni e delle risorse sottostanti. Per saperne di più, consulta Concedere ruoli al service account.
  • Il ruolo Project IAM Admin (roles/resourcemanager.projectIamAdmin) nella cartella abilitata per le app. Questo ruolo consente di creare un nuovo account di servizio durante il deployment.

Esegui il deployment dell'applicazione

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

Canvas di progettazione

  1. Nel 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.

  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 unaccount di serviziot esistente. Per configurare il service account, vedi Concedere 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 in anteprima le modifiche che Terraform prevede di apportare alla tua infrastruttura, svolgi i seguenti passaggi:

    1. Fai clic su Anteprima.

    2. Controlla 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 Rivedi API, esamina l'elenco delle API richieste per la tua applicazione. Le API vengono attivate automaticamente al momento del deployment.

  9. Fai clic su Esegui il deployment. Man mano che il deployment viene completato, vengono visualizzati i dettagli dell'applicazione e lo stato del deployment.

  10. Se si verificano problemi con l'implementazione:

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

    2. Controlla i messaggi di errore.

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

  11. Per gestire l'applicazione di cui è stato eseguito il deployment, vedi Visualizzare i dettagli dell'applicazione.

Interfaccia a riga di comando gcloud

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

    • Per creare automaticamente un account di servizio, utilizza questo 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: il tuo ID spazio.
    • SERVICE_ACCOUNT: esegui una delle seguenti operazioni:
      • Per creare un nuovo account di servizio, fornisci un nome.
      • 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:

    • Per creare automaticamente un account di servizio, utilizza questo 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: il tuo ID spazio.
    • SERVICE_ACCOUNT: esegui una delle seguenti operazioni:
      • Per creare un nuovo account di servizio, fornisci un nome.
      • Per utilizzare il tuo account di servizio, fornisci il nome completo della risorsa nel formato projects/PROJECT/serviceAccounts/EMAIL_ADDRESS.

    Per saperne di più, 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 dall'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 saperne di più, consulta gcloud design-center operations describe.

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 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. Nel 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 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 Monitorare le applicazioni App Hub.

    • Dettagli 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 i problemi.

Interfaccia a riga di comando gcloud 

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: il tuo ID spazio.

Per saperne di più, consulta 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 esegui nuovamente il deployment dell'applicazione:

Applicare le revisioni del modello

Se la tua applicazione è stata precedentemente implementata utilizzando Application Design Center e un amministratore ha condiviso con te una revisione del modello, puoi applicare le modifiche al modello alla tua applicazione. Quando aggiorni la tua richiesta, viene creata una revisione della richiesta. 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 saperne di più, vedi Visualizzare i deployment.

Per applicare le revisioni del modello alla tua applicazione:

Canvas di progettazione

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

    Vai ai Modelli

  2. Fai clic sull'ID modello contenente 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.

Interfaccia a riga di comando gcloud

  1. Identifica l'URI della revisione del template di 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 modello di applicazione che è la base della tua applicazione.
    • PROJECT: l'ID progetto di gestione.
    • LOCATION: La regione del modello di applicazione.
    • SPACE: il tuo ID spazio.

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

  2. Copia l'output di latestRevision.

  3. Aggiorna l'applicazione per utilizzare la revisione del template 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: il tuo ID 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 saperne di più, consulta 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.