Gestisci applicazioni

La creazione di una bozza di applicazione da un template in Application Design Center ti consente di personalizzare ed eseguire il deployment di istanze di applicazioni separate per ambienti come test e produzione. Quando crei una bozza di applicazione, specifichi gli attributi per categorizzare e filtrare l'applicazione, configuri i componenti e le connessioni e, facoltativamente, modifichi il codice Terraform generato. Puoi anche creare nuove revisioni man mano che i tuoi requisiti cambiano ed eliminare l'applicazione quando non hai più bisogno delle risorse di cui hai eseguito il deployment.

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
Creare, configurare, modificare e creare versioni delle bozze delle applicazioni	Application Design Center Admin (roles/designcenter.admin) o Application Admin (roles/designcenter.applicationAdmin) o Application Editor (roles/designcenter.applicationEditor)
Elimina un'applicazione	Application Design Center Admin (roles/designcenter.admin) o Application Admin (roles/designcenter.applicationAdmin)

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

Creare una bozza di richiesta

Crea una bozza di applicazione da un template specificando i dettagli e, facoltativamente, eseguendo l'override delle configurazioni dei componenti. Puoi quindi eseguire il deployment della bozza per creare un'applicazione.

Canvas di progettazione

1. Nel menu di navigazione, esegui una delle seguenti operazioni:

   • Per visualizzare i modelli creati nel tuo spazio, fai clic su Modelli.

     Vai ai Modelli

   • Per visualizzare i modelli condivisi da un altro spazio, fai clic su Modelli condivisi.

     Vai a Modelli condivisi

2. Fai clic sull'ID modello che vuoi utilizzare.

3. Nel canvas di progettazione, fai clic su Configura un'app, poi su Crea nuova applicazione.

4. Nell'area Nome applicazione, segui questi passaggi per assegnare un nome e una descrizione alla tua applicazione:

   1. Nel campo Nome, inserisci un identificatore univoco in questo spazio. Ad esempio, utilizza una combinazione univoca di nome e ambiente come web-app-staging. Questo campo è obbligatorio.

      Puoi utilizzare fino a 63 caratteri, tra cui lettere minuscole, numeri e trattini. Il nome deve iniziare con una lettera minuscola e non può terminare con un trattino. I nomi non possono essere modificati.

   2. Nel campo Nome visualizzato, inserisci un nome da visualizzare nella consoleGoogle Cloud .

   3. Nel campo Descrizione, inserisci lo scopo di questa applicazione.

5. Per impostare un progetto predefinito per tutti i componenti con un campo ID progetto vuoto, seleziona un progetto dall'elenco Progetto di deployment. In un confine a livello di cartella, il progetto deve avere le seguenti qualifiche:

   • Il progetto deve trovarsi all'interno della cartella app selezionata.
   • Il progetto non deve essere un progetto di gestione.

   Se un componente ha già un progetto specificato nel campo ID progetto, viene utilizzato quel progetto anziché questa impostazione.

6. Dall'elenco Regione, seleziona la regione in cui viene eseguito il deployment dei componenti. La regione del componente viene applicata in base a quanto segue:

   • Se l'ambito dell'applicazione è Globale (predefinito), la regione viene applicata ai componenti che non hanno ancora una regione configurata.

   • Se l'ambito dell'applicazione è Regionale, la regione viene applicata a tutti i componenti.

7. Dall'elenco Ambiente, seleziona l'ambiente in cui vuoi eseguire il deployment di questa applicazione. Ad esempio, potresti voler verificare che il tuo deployment funzioni come previsto in TEST.

   Nota: se prevedi di eseguire il deployment di questa applicazione e di eliminarla in un secondo momento, esegui il deployment in TEST, DEVELOPMENT o STAGING.

8. Dall'elenco Criticità, seleziona il grado di impatto sulla tua attività. Ad esempio: LOW o HIGH.

9. Per specificare i proprietari, nell'area Proprietari, fai clic su Aggiungi proprietario e inserisci un Nome visualizzato e un'email per i seguenti:

   • Nell'area Proprietari dell'attività, inserisci un proprietario responsabile della qualità e delle aspettative degli utenti.

   • Nell'area Proprietari sviluppatori, inserisci un proprietario responsabile dello sviluppo e della programmazione.

   • Nell'area Proprietari operatori, inserisci un proprietario responsabile del funzionamento dell'applicazione.

10. Nell'elenco Ambito, seleziona una delle seguenti opzioni:

    • Globale (predefinita): l'applicazione contiene una risorsa globale o le risorse si trovano in più regioni.

    • Regionale: tutte le risorse si trovano in un'unica regione.

    Questo campo è obbligatorio. Per saperne di più, consulta Confronta le applicazioni globali e regionali.

11. Fai clic su Crea applicazione. Vengono visualizzati i dettagli dell'applicazione.

gcloud CLI

1. Identifica l'URI della revisione del template di applicazione per il template che vuoi utilizzare per creare l'applicazione.

    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 dell'applicazione che vuoi utilizzare come base per la tua 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. Crea una bozza di richiesta basata sul tuo modello.

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

   Sostituisci quanto segue:

   • APPLICATION: l'ID applicazione della bozza dell'applicazione che vuoi creare.
   • 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
   • SCOPE_TYPE: l'ambito della tua applicazione. regional o global. Se l'ambito dell'applicazione è "globale, the region is applied to components that don't already have a configured region. If the application scope isregionale", la regione viene applicata a tutti i componenti.

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

Configura componenti e connessioni

Per ogni componente dell'applicazione, puoi specificare i dettagli di configurazione, ad esempio il progetto in cui viene creata la risorsa e la località in cui viene eseguito il deployment.

Puoi anche modificare i dettagli della connessione se la configurazione predefinita non soddisfa i tuoi requisiti. Ad esempio, potresti modificare i nomi delle chiavi delle variabili di ambiente, cambiare le porte di connessione o aggiungere altri ruoli ai service account.

Devi configurare i dettagli richiesti per ogni risorsa supportata.

Per configurare i componenti e le connessioni, segui questi passaggi:

Canvas di progettazione

1. Nel canvas di progettazione, fai clic su un componente.

2. Nell'area Configurazione, nell'elenco ID progetto, seleziona il progetto in cui vuoi eseguire il deployment della risorsa. Seleziona un progetto con le seguenti qualifiche:

   • Il progetto deve trovarsi all'interno della cartella abilitata per le app selezionata.

   • Il progetto non deve essere un progetto di gestione.

3. Configura impostazioni aggiuntive per la risorsa. Ad esempio, per Cloud SQL, puoi configurare quanto segue:

   • Regione
   • Configurazione del backup
   • Flag di database
   • Configurazione IP

   Per i link alla documentazione di configurazione di ciascun componente, consulta Risorse supportate.

4. Quando colleghi i componenti nel canvas di progettazione, vengono utilizzati i valori di configurazione predefiniti per creare la connessione. Per aggiungere o modificare i dettagli della connessione, segui questi passaggi.

   1. Nel canvas di progettazione, fai clic sulla connessione tra due componenti. Si apre il riquadro Connessione, che mostra i parametri di connessione.

   2. Esegui una delle seguenti operazioni:

      • Per modificare un parametro di connessione esistente, fai clic su Modifica.

      • Per aggiungere un nuovo parametro di connessione, fai clic su Aggiungi parametro.

   3. Aggiorna i campi Chiave e Valore. Ad esempio, potresti voler modificare i seguenti dettagli:

      • I nomi delle chiavi variabile di ambiente in modo che siano in linea con i requisiti della tua applicazione.
      • Il valore della porta di connessione.
      • I ruoli aggiunti a un account di servizio.

5. Fai clic su Salva.

gcloud CLI

1. Descrivere l'applicazione per visualizzare i parametri dei componenti e identificare i parametri richiesti per l'applicazione.

    gcloud design-center spaces applications describe APPLICATION \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE \
    --format='yaml(name,componentParameters)'
   

   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.

2. Per ogni componente che vuoi modificare, crea un file JSON nella tua home directory contenente i valori dei parametri.

   Ad esempio, puoi creare il seguente file per un componente Cloud Run:

     {
       "component": "projects/PROJECT/locations/us-central1/spaces/SPACE/applicationTemplates/APPLICATION_TEMPLATE/components/COMPONENT",
       "parameters": [
          {
             "key": "service_name",
             "value": "frontend-service"
          },
          {
             "key": "project_id",
             "value": "DEPLOYMENT_PROJECT"
          }
       ]
     }
   

3. Aggiorna l'applicazione per configurare i parametri richiesti.

    gcloud design-center spaces applications update APPLICATION \
    --project=PROJECT \
    --location=LOCATION \
    --space=SPACE \
    --component-parameters=COMPONENT_FILE_PATH_1
   

   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.
   • COMPONENT_FILE_PATH_1: un file JSON che include i parametri del componente. Per ogni file JSON aggiuntivo, aggiungi un altro argomento e valore --component-parameter.

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

Per i passaggi di deployment, consulta Esegui il deployment delle applicazioni.

Verifica la conformità della sicurezza

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.

Puoi eseguire una valutazione della sicurezza della tua applicazione per convalidare la configurazione rispetto ai framework di Security Command Center. Questa valutazione completa analizza quanto segue:

• Valori di configurazione dei componenti: le impostazioni di configurazione ereditate automaticamente dal template o le impostazioni che hai modificato per questa applicazione.
• Parametri dell'applicazione: i dettagli specifici dell'istanza forniti per la tua applicazione, ad esempio la regione o l'ambiente di deployment.
• Componenti consentiti: i servizi e i workload nell'applicazione corrente che la tua organizzazione può utilizzare.

Le applicazioni ereditano i framework di Security Command Center dal relativo template. Innanzitutto, l'amministratore deve collegare un framework di sicurezza al template dell'applicazione. Quindi, segui questi passaggi per valutare la conformità della sicurezza dalla tua applicazione:

gcloud CLI

  gcloud alpha design-center spaces applications preview APPLICATION \
  --project=PROJECT \
  --location=LOCATION \
  --space=SPACE \
  --generate-assessment-report=true

Sostituisci quanto segue:

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

L'output mostra un report di valutazione per la tua applicazione in base ai framework allegati al template.

Modifica il codice Terraform

L'applicazione genera il codice Terraform per riflettere i dettagli di progettazione e configurazione. Puoi modificare Terraform per specificare i dettagli di configurazione dei componenti.

Il sistema genera i seguenti file Terraform:

• main.tf: codice dell'infrastruttura che include un modulo per ogni componente del template.
• outputs.tf: espone le informazioni sui componenti dell'infrastruttura di cui è stato eseguito il deployment.
• variables.tf: dichiara il nome, il tipo e la descrizione delle variabili utilizzate nel file main.tf.
• input.tfvars: definisce i valori per le variabili utilizzate nel file main.tf.
• providers.tf: definisce le etichette che aiutano Terraform a interagire con le API e le risorse Google Cloud .

Per informazioni di base, consulta Panoramica di Terraform suGoogle Cloud.

Per modificare il codice Terraform, segui questi passaggi:

1. Nel canvas di progettazione, fai clic su Codice. Il sistema visualizza i file Terraform generati.

2. Fai clic su main.tf. Il sistema visualizza il modulo Terraform per ogni componente.

3. Modifica i dettagli della configurazione. Per saperne di più, consulta la documentazione di configurazione di ogni risorsa supportata.

   Il sistema convalida automaticamente le modifiche e visualizza gli errori se le modifiche non sono valide.

4. Per evidenziare e confrontare le modifiche:

   1. Fai clic su Visualizza differenze.

   2. Per ripristinare una modifica, fai clic su Fai clic per ripristinare la modifica nel margine.

   3. Fai clic su Visualizza differenze per chiudere la visualizzazione di confronto.

5. Per salvare le modifiche, fai clic su Salva le modifiche al codice.

6. Per verificare le modifiche, segui questi passaggi.

   1. Fai clic su Design.
   2. Fai clic su un componente ed esamina i dettagli della configurazione.

Crea una revisione dell'applicazione

Crea una revisione dell'applicazione per modificare i dettagli o i componenti. Se modifichi i componenti dell'applicazione al di fuori di App Design Center, queste modifiche non vengono conservate quando esegui nuovamente il deployment.

Per creare una revisione 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 che vuoi rivedere.

3. Per modificare i dettagli dell'applicazione:

4. Fai clic su Modifica e modifica i dettagli.

5. Fai clic su Salva per salvare le modifiche.

6. Per modificare un componente in questa applicazione, segui questi passaggi:

   1. Fai clic sul componente nel canvas di progettazione e modifica i dettagli nell'area Configurazione.

   2. Fai clic su Salva per salvare le modifiche.

gcloud CLI

Consulta Configura componenti e connessioni.

Per i passaggi di deployment, consulta Esegui il deployment delle applicazioni.

Elimina un'applicazione

Se non hai più bisogno di un'applicazione, puoi eliminarla. Ad esempio, potresti eseguire il deployment di un'applicazione per verificare il template nell'ambiente TEST, quindi eliminare l'applicazione.

Puoi eliminare le seguenti applicazioni:

• Un'applicazione di cui non è stato eseguito il deployment. Nella pagina Applicazioni, lo Stato è indicato come Bozza.
• Un'applicazione di cui è stato eseguito il deployment nell'ambiente TEST, DEVELOPMENT o STAGING.

Quando elimini un'applicazione, si verifica quanto segue:

• I dettagli dell'applicazione vengono rimossi da App Design Center.
• L'applicazione App Hub sottostante viene eliminata.
• Se hai eseguito il deployment, le risorse vengono eliminate.

Per eliminare un'applicazione:

Canvas di progettazione

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

   Vai a Applicazioni

2. Nella tabella, fai clic su Nome applicazione.

3. Fai clic su Azioni e seleziona Elimina applicazione.

4. Nel campo Elimina, inserisci il nome dell'applicazione.

5. Fai clic su Elimina.

gcloud CLI

Elimina un'applicazione.

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

Sostituisci quanto segue:

• APPLICATION: l'ID applicazione dell'applicazione che vuoi eliminare.
• 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 delete.

Passaggi successivi

• Esegui il provisioning della tua infrastruttura con la console o la riga di comando eseguendo il deployment delle applicazioni.
• Esporta le configurazioni Terraform nella tua macchina o nel tuo repository locale scaricando ed eseguendo il deployment di Terraform.