Gli amministratori creano modelli di applicazioni per garantire che l'architettura preferita venga utilizzata da ogni team di sviluppo. In questo modo puoi controllare le risorse e le configurazioni utilizzate dagli sviluppatori nei deployment delle applicazioni.
Una volta creato un modello di applicazione, gli altri utenti dello spazio possono accedervi. Puoi anche aggiungere un modello a un catalogo da condividere con altri spazi.
Gli sviluppatori possono utilizzare il tuo modello per creare ed eseguire il deployment di un'applicazione. Quando gli sviluppatori creano un'applicazione, possono configurare ogni componente dal template, ma non possono aggiungere o rimuovere componenti. Il modello genera codice Terraform, che gli sviluppatori possono scaricare o eseguire il deployment da App Design Center.
Questo documento ti aiuta a progettare, configurare e condividere un modello di applicazione utilizzando App Design Center.
Prima di iniziare
Devi disporre di uno dei seguenti ruoli nella cartella o nel progetto di gestione abilitato per le app:
- Application Design Center Admin (
roles/designcenter.admin) - Application Design Center User (
roles/designcenter.user)
Creare un modello di applicazione
Crea modelli di applicazioni per condividere la progettazione dell'architettura con i team di sviluppo. Puoi aggiungere i seguenti componenti al design del modello:
Asset: risorse di alto livello che ti aiutano a controllare altre risorse. Ad esempio, service account.
Servizi: interfacce di rete o API utilizzate sulla rete. Alcuni esempi sono Cloud Storage e Vertex AI.
Workload: deployment binari che eseguono funzioni aziendali. Gli esempi includono Cloud Run e Compute Engine.
Puoi scegliere tra i seguenti componenti:
- Componenti progettati da Google, che incorporano Google Cloud best practice e configurazioni di sicurezza predefinite.
- I tuoi componenti che importi, basati sui tuoi moduli Terraform.
Man mano che progetti il modello, App Design Center genera codice Terraform per riflettere i dettagli di progettazione e configurazione.
Specifica i dettagli del modello
I dettagli del modello ti aiutano a classificarlo e a decidere se utilizzarlo.
Per inserire i dettagli del modello:
Dal menu di navigazione, fai clic su Modelli.
Fai clic su Crea modello.
Nel campo ID modello, inserisci un identificatore univoco per il modello. Questo campo è obbligatorio.
Nel campo Nome modello, inserisci un identificatore leggibile da persone da visualizzare nella console Google Cloud .
Se non fornisci un nome, in questo campo viene copiato l'ID modello.
Nel campo Descrizione, inserisci una breve spiegazione dello scopo dell'applicazione.
Fai clic su Crea modello. Viene visualizzato il canvas di progettazione.
Progettare il modello
Progetta il modello aggiungendo e collegando i componenti nel canvas di progettazione. L'esempio seguente include tre componenti connessi.
Puoi progettare il modello aggiungendo componenti ai seguenti punti di partenza:
- Una tela bianca.
- Un modello fornito da Google.
- Un modello che generi con l'assistenza di Gemini.
Per progettare il modello:
Nell'area di progettazione, assicurati che sia selezionato Progettazione.
Per iniziare, esegui una delle seguenti operazioni:
Per iniziare da zero, nell'area Componenti, fai clic su un componente per aggiungerlo all'area del canvas.
Per iniziare da un modello fornito da Google, fai clic sul nome del modello.
Per utilizzare la chat in linguaggio naturale per generare un modello, fai clic su Applicazione personalizzata con Gemini.
Per creare un canale di comunicazione tra i componenti, esegui una delle seguenti operazioni:
Per connettere due componenti sul canvas, trascina un punto blu di un componente a un punto blu di un altro componente.
Per aggiungere un componente esistente, fai clic su Aggiungi e seleziona il componente da aggiungere.
Per i dettagli della connessione, consulta la documentazione di configurazione per ogni risorsa supportata.
Per rimuovere un componente o una connessione:
Nell'area di lavoro, fai clic sul componente o sulla connessione.
Nell'area Configurazione, fai clic su Elimina.
Nel campo, inserisci delete.
Fai clic su Elimina.
Configurare i valori predefiniti per i componenti
Per ogni componente che aggiungi al canvas, puoi specificare i dettagli di configurazione, ad esempio il progetto in cui viene creata la risorsa e la posizione in cui viene eseguito il deployment. Se specifichi i dettagli di configurazione, Application Design Center li utilizza come valori predefiniti per le applicazioni.
Puoi anche modificare i dettagli della connessione se la configurazione predefinita non soddisfa i tuoi requisiti. Ad esempio, puoi modificare i nomi delle chiavi delle variabile di ambiente, cambiare le porte di connessione o aggiungere ruoli aggiuntivi ai service account.
Prima di eseguire il deployment di un'applicazione, gli sviluppatori possono visualizzare e modificare i valori predefiniti che hai configurato nel modello. Gli sviluppatori devono configurare i dettagli richiesti per ogni risorsa supportata.
Per configurare i componenti e le connessioni:
Nell'area di progettazione, fai clic su un componente.
Nell'area Configurazione, seleziona il progetto in cui vuoi eseguire il deployment della risorsa dall'elenco ID progetto. Seleziona un progetto con le seguenti qualifiche:
Il progetto deve essere un discendente della cartella abilitata per le app selezionata.
Il progetto non deve essere un progetto di gestione.
Configura le impostazioni aggiuntive per la risorsa. Ad esempio, per Cloud SQL, potresti 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.
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:
Nel canvas di progettazione, fai clic sulla connessione tra due componenti. Si apre il riquadro Connessione, che mostra i parametri di connessione.
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.
Aggiorna i campi Chiave e Valore. Ad esempio, potresti voler modificare i seguenti dettagli:
- I nomi delle chiavi variabile di ambiente da allineare ai requisiti dell'applicazione.
- Il valore della porta di connessione.
- I ruoli aggiunti a un account di servizio.
Fai clic su Salva.
Modifica il codice Terraform
Man mano che progetti il modello di applicazione, Application Design Center 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 modello.outputs.tf: espone 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 filemain.tf.input.tfvars: definisce i valori delle variabili utilizzate nel filemain.tf.providers.tf: definisce le etichette che aiutano Terraform a interagire con le API e le risorse di Google Cloud .
Per informazioni di base, consulta Panoramica di Terraform su Google Cloud.
Per modificare il codice Terraform:
Nell'area di lavoro, fai clic su Codice. Il sistema mostra i file Terraform generati.
Fai clic su main.tf. Il sistema mostra il modulo Terraform per ogni componente.
Modifica i dettagli di configurazione. Per ulteriori informazioni, consulta la documentazione di configurazione per ogni risorsa supportata.
Il sistema convalida automaticamente le modifiche e mostra gli errori se le modifiche non sono valide.
Per evidenziare e confrontare le modifiche:
Fai clic su Visualizza diff.
Per ripristinare una modifica, fai clic su Fai clic per ripristinare la modifica nel margine.
Fai clic su Visualizza diff per chiudere la visualizzazione del confronto.
Per salvare le modifiche, fai clic su Salva modifiche al codice.
Per verificare le modifiche, procedi nel seguente modo.
- Fai clic su Design.
- Fai clic su un componente ed esamina i dettagli della configurazione.
Eliminare un modello
Se non hai più bisogno di un modello, puoi eliminarlo.
- Nell'area di progettazione, fai clic su Azioni.
- Fai clic su Elimina.
Verifica il modello
Prima di condividere il modello con gli sviluppatori, assicurati che funzioni come previsto. Per verificare il modello:
- Crea un'applicazione con
le seguenti impostazioni:
- Dall'elenco Environment (Ambiente), seleziona TEST.
- Nell'elenco Criticalità, seleziona BASSA.
- Esegui il deployment dell'applicazione. Per i passaggi per il deployment, vedi Deployment di un'applicazione dalla console.
- Testa la tua infrastruttura per assicurarti che soddisfi i tuoi requisiti.
- Per evitare costi ricorrenti, elimina il deployment di test.
Condividere un modello in un catalogo
Una volta verificato il modello, puoi pubblicarlo in un catalogo. Il modello può essere utilizzato dagli sviluppatori di applicazioni che hanno accesso a uno spazio in cui è condiviso il catalogo.
- Nell'area di progettazione, fai clic su Aggiungi al catalogo.
- Per gestire gli spazi in cui viene condiviso il catalogo, vedi Gestire i cataloghi.
Rivedi e condividi nuovamente il modello
Man mano che acquisisci esperienza con l'applicazione e le tue esigenze aziendali si evolvono, potresti voler aggiornare il modello di applicazione. Ad esempio, potresti decidere di migliorare le prestazioni di un servizio di backend aggiungendo un servizio Memorystore per la memorizzazione nella cache.
Quando modifichi un modello, crei una revisione del modello. Per applicare le modifiche alle applicazioni esistenti, gli sviluppatori devono eseguire il deployment delle applicazioni utilizzando la revisione.
App Design Center non pubblica automaticamente le revisioni dei modelli nei cataloghi. Per condividere l'ultima revisione, pubblica di nuovo il modello nel catalogo.
Per creare una nuova revisione:
Dal menu di navigazione, fai clic su Modelli.
Seleziona il modello di richiesta che vuoi rivedere. Si apre il canvas.
Modifica il modello in base ai nuovi requisiti. Ad esempio, aggiungi e configura un nuovo componente.
Per condividere l'ultima revisione con altri spazi, aggiungi di nuovo il modello ai cataloghi pertinenti.
Passaggi successivi
Per condividere i modelli con altri spazi, crea e condividi un catalogo.
Per utilizzare i tuoi moduli Terraform nella progettazione del modello di applicazione, importa i componenti.
Prima del deployment, crea un'applicazione.