Progetta ed esegui il deployment di un'applicazione utilizzando Gemini CLI

Utilizza i server Model Context Protocol (MCP) di Gemini Cloud Assist e App Design Center per progettare, eseguire il deployment e risolvere i problemi dell'infrastrutturaGoogle Cloud direttamente in Gemini CLI.

Obiettivi

Questo tutorial ti aiuterà a:

Configura Gemini CLI per utilizzare i server MCP di Gemini Cloud Assist e App Design Center.
Progetta ed esegui il deployment di un'infrastruttura Google Cloud ottimizzata per l'esecuzione del codice dell'applicazione esistente.
Analizza e risolvi i problemi tecnici.

Costi

In questo documento vengono utilizzati i seguenti componenti fatturabili di Google Cloud:

App Design Center.
Google Cloud resources that you create as part of your application infrastructure.

Per generare una stima dei costi in base all'utilizzo previsto, utilizza il calcolatore prezzi.

I nuovi utenti di Google Cloud potrebbero avere diritto a una prova senza costi.

Al termine delle attività descritte in questo documento, puoi evitare l'addebito di ulteriori costi eliminando le risorse che hai creato. Per saperne di più, consulta Esegui la pulizia.

Prima di iniziare

Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

Installa Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Crea o seleziona un Google Cloud progetto.

Ruoli richiesti per selezionare o creare un progetto

Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto per il quale ti è stato concesso un ruolo.
Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. Scopri come concedere i ruoli.

Creare un progetto Google Cloud :
```
gcloud projects create PROJECT_ID
```
Sostituisci PROJECT_ID con un nome per il progetto Google Cloud che stai creando.
Seleziona il progetto Google Cloud che hai creato:
```
gcloud config set project PROJECT_ID
```
Sostituisci PROJECT_ID con il nome del progetto Google Cloud .

Verifica che la fatturazione sia abilitata per il tuo progetto Google Cloud .

Installa Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Crea o seleziona un Google Cloud progetto.

Ruoli richiesti per selezionare o creare un progetto

Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto per il quale ti è stato concesso un ruolo.
Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. Scopri come concedere i ruoli.

Creare un progetto Google Cloud :
```
gcloud projects create PROJECT_ID
```
Sostituisci PROJECT_ID con un nome per il progetto Google Cloud che stai creando.
Seleziona il progetto Google Cloud che hai creato:
```
gcloud config set project PROJECT_ID
```
Sostituisci PROJECT_ID con il nome del progetto Google Cloud .

Verifica che la fatturazione sia abilitata per il tuo progetto Google Cloud .

Per accedere a Gemini Cloud Assist tramite MCP, devi partecipare al programma Trusted Tester. Contatta il team dedicato all'account per richiedere l'accesso.
Installa Gemini CLI.
Assicurati di disporre del ruolo App Design Center Admin (roles/designcenter.admin) nel tuo progetto.
Assicurati di disporre di un ruolo che includa l'autorizzazione mcp.googleapis.com/tools.call, ad esempio uno dei seguenti ruoli Gemini Cloud Assist:

Amministratore di Gemini Cloud Assist (roles/geminicloudassist.admin).
Gemini Cloud Assist Editor (roles/geminicloudassist.editor).
Utente Gemini Cloud Assist (roles/geminicloudassist.user).

Prepara l'ambiente

Per preparare l'ambiente, esegui l'autenticazione su Google Cloud e attiva i servizi richiesti.

Autenticati per Google Cloud

Autenticati su Google Cloud eseguendo questo comando nel terminale:

Configura le Credenziali predefinite dell'applicazione per consentire ai server MCP di effettuare chiamate API.
```
 gcloud auth application-default login
```

Abilita API

Attiva i servizi Gemini Cloud Assist e App Design Center nel tuo progetto.

Abilita il servizio Gemini Cloud Assist nel tuo progetto:

 gcloud services enable geminicloudassist.googleapis.com

Abilita il servizio App Design Center nel tuo progetto:
```
 gcloud services enable designcenter.googleapis.com
```

Configura i server MCP

I server MCP di Gemini Cloud Assist e App Design Center ti aiutano a progettare, valutare, implementare e risolvere i problemi relativi all'infrastruttura Google Cloud utilizzando prompt in linguaggio naturale. Per connetterti ai server MCP, configura le impostazioni di Gemini CLI.

Per configurare Gemini CLI in modo da utilizzare i server MCP:

Apri il file di configurazione di Gemini CLI in una delle seguenti posizioni:
- Ambito utente: per applicare le impostazioni a tutti i tuoi progetti Gemini CLI, apri ~/.gemini/settings.json.
- Ambito Workspace: per applicare le impostazioni a un progetto Gemini CLI specifico, apri .gemini/settings.json.
Se il file di configurazione non esiste, creane uno nuovo.

In settings.json, aggiungi o unisci il seguente blocco di configurazione alla chiave mcpServers.

  {
    "mcpServers": {
      "gemini-cloud-assist": {
        "httpUrl": "https://geminicloudassist.googleapis.com/mcp",
        "authProviderType": "google_credentials",
        "oauth": {
          "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
        },
        "timeout": 600000
      },
      "application-design-center": {
        "httpUrl": "https://designcenter.googleapis.com/mcp",
        "authProviderType": "google_credentials",
        "oauth": {
          "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
        },
        "timeout": 600000
      }
    }
  }

Questa configurazione utilizza automaticamente le Credenziali predefinite dell'applicazione.

Salva e chiudi il file di configurazione.
Avvia Gemini CLI.
```
gemini
```
Verifica che i server MCP siano connessi.
```
/mcp list
```

Installare i file `SKILL.md`

I file SKILL.md forniscono ad App Design Center e ai server MCP di Gemini Cloud Assist istruzioni e flussi di lavoro per la progettazione, il deployment e la risoluzione dei problemi dell'infrastruttura.

Per aggiungere file SKILL.md a Gemini CLI:

Crea una directory skills/design-and-deploy in una delle seguenti posizioni:
- Ambito utente: per applicare le impostazioni a tutti i tuoi progetti dell'interfaccia a riga di comando di Gemini, crea ~/.gemini/skills/design-and-deploy/.
- Scope di Workspace: per applicare le impostazioni a un progetto specifico della CLI Gemini, crea .gemini/skills/design-and-deploy/.
Nella directory skills/design-and-deploy/, crea un file SKILL.md utilizzando i contenuti di designing-and-deploying-infrastructure.
Crea una directory skills/google-gemini-cloud-assist in una delle seguenti posizioni:
- Ambito utente: per applicare le impostazioni a tutti i tuoi progetti dell'interfaccia a riga di comando di Gemini, crea ~/.gemini/skills/google-gemini-cloud-assist/.
- Scope di Workspace: per applicare le impostazioni a un progetto specifico della CLI Gemini, crea .gemini/skills/google-gemini-cloud-assist/.
Nella directory skills/google-gemini-cloud-assist/, crea un file SKILL.md utilizzando i contenuti di operating-google-cloud.
Esci e riavvia Gemini CLI.
```
/quit
```
Quando riavvii Gemini CLI, il file di competenze viene rilevato automaticamente.
Verifica che il file di skill sia stato rilevato automaticamente.
```
/skills list
```

Hai configurato correttamente Gemini CLI per connettersi ai server MCP di App Design Center e Gemini Cloud Assist e hai creato file di competenze.

Progetta la tua Google Cloud infrastruttura

Progetta un'infrastruttura personalizzata per archiviare ed eseguire il codice dell'applicazione.

Imposta il progetto che vuoi utilizzare:
```
gcloud config set project PROJECT_ID
```
Richiedi la progettazione dell'infrastruttura. Google Cloud
```
 My application code is in REPOSITORY_URL. Design the Google Cloud infrastructure required for my application.
```
L'agente chiede di attivare le skill che hai configurato. L'agente crea un piano di progettazione dell'infrastruttura e chiede la tua approvazione.
Approva il piano.
```
Continue with the plan.
```
L'agente identifica gli strumenti da utilizzare per creare l'infrastruttura. L'agente chiede di utilizzare lo strumento setup_adc, che configura App Design Center nel tuo progetto.
Consenti a Gemini Cloud Assist di utilizzare gli strumenti proposti.

L'agente propone un progetto e ti chiede se sei pronto per la distribuzione.
Itera sul progetto proposto.
```
The infrastructure looks good, but I want to add a cache for frequently accessed data.
```
L'agente aggiorna il progetto per integrare il tuo requisito. L'agente ti chiede se vuoi una spiegazione delle modifiche o se vuoi testarle.

Hai creato il progetto dell'infrastruttura iniziale e hai eseguito iterazioni per migliorarlo.

Valutare la conformità agli standard di sicurezza

Gli amministratori della tua organizzazione hanno probabilmente configurato framework di sicurezza specifici che informano la progettazione e l'implementazione dell'infrastruttura. In questa sezione, verifica che il tuo progetto sia conforme agli standard di sicurezza configurati.

Assicurati che la progettazione dell'infrastruttura sia conforme agli standard di sicurezza della tua organizzazione.
```
I want to make sure that infrastructure design is compliant with my organization's security standards.
```
L'agente analizza la progettazione dell'infrastruttura in base ai framework di sicurezza specificati dall'amministratore della tua organizzazione in Security Command Center. Se l'audit rileva problemi di conformità, l'agente suggerisce miglioramenti della sicurezza e chiede la tua approvazione.
Applica i miglioramenti della sicurezza consigliati
```
Apply the recommended security enhancements.
```
L'agente applica le modifiche e ti chiede se sei pronto ad approvare il progetto.

La progettazione dell'infrastruttura è conforme ai framework di sicurezza della tua organizzazione.

Esegui il deployment della progettazione dell'infrastruttura

Esegui il deployment della progettazione dell'infrastruttura su Google Cloud.

Approva il design ed esegui il deployment.
```
Deploy the infrastructure design to my Google Cloud project.
```
L'agente esegue il deployment del progetto finale nel tuo progetto Google Cloud . L'agente ti chiede di approvare le modifiche al tuo progetto. Ad esempio, potresti dover abilitare un'API.

Se l'applicazione viene implementata correttamente, l'agente mostra i dettagli dell'implementazione, i componenti dell'architettura e i passaggi per utilizzare l'applicazione.
Se il deployment non va a buon fine, ricevi assistenza per la risoluzione dei problemi. Ad esempio, potresti dover correggere i dettagli di configurazione dei componenti o le autorizzazioni Identity and Access Management (IAM).
```
Fix the component configuration errors.
```
L'agente fornisce consigli per le configurazioni dei componenti e crea una visualizzazione delle differenze da esaminare e accettare.
Per riprovare il deployment dopo aver apportato le modifiche, ripeti i passaggi descritti in questa sezione.

Hai eseguito il deployment del codice dell'applicazione e della progettazione dell'infrastruttura in Google Cloud.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, elimina il progetto che contiene le risorse oppure mantieni il progetto ed elimina le singole risorse.

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per, le attività descritte in questo documento, eliminerai anche tutto il lavoro che hai svolto nel progetto.
Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più architetture, tutorial o guide rapide, puoi riutilizzare i progetti ed evitare così di superare i limiti di quota.

Elimina un progetto Google Cloud :

gcloud projects delete PROJECT_ID

Passaggi successivi

Scopri come monitorare l'integrità e le prestazioni delle applicazioni.
Esplora architetture, diagrammi e best practice di riferimento su Google Cloud. Consulta il nostro Cloud Architecture Center.