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

Google Cloud

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

Obiettivi

Questo tutorial ti aiuta a:

  • Configurare Gemini CLI per utilizzare i server MCP di Gemini Cloud Assist e App Design Center.
  • Progettare ed eseguire il deployment di un'infrastruttura Google Cloud ottimizzata per l'esecuzione del codice dell'applicazione esistente.
  • Analizzare e risolvere 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 Google Cloud utenti 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

  1. Accedi al tuo Google Cloud account. Se non hai mai utilizzato Google Cloud, crea un account per valutare il rendimento dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per eseguire, testare ed eseguire il deployment dei carichi di lavoro.

  2. Installa Google Cloud CLI.

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

  4. Per inizializzare gcloud CLI, esegui questo comando: 

    gcloud init

  5. 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 su cui ti è stato concesso un ruolo.
    • Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l' resourcemanager.projects.create autorizzazione. Scopri come concedere i ruoli.

    • Crea un Google Cloud progetto:

      gcloud projects create PROJECT_ID

      Sostituisci PROJECT_ID con un nome per il Google Cloud progetto che stai creando.

    • Seleziona il Google Cloud progetto che hai creato:

      gcloud config set project PROJECT_ID

      Sostituisci PROJECT_ID con il nome del Google Cloud progetto.

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

  7. Installa Google Cloud CLI.

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

  9. Per inizializzare gcloud CLI, esegui questo comando: 

    gcloud init

  10. 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 su cui ti è stato concesso un ruolo.
    • Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l' resourcemanager.projects.create autorizzazione. Scopri come concedere i ruoli.

    • Crea un Google Cloud progetto:

      gcloud projects create PROJECT_ID

      Sostituisci PROJECT_ID con un nome per il Google Cloud progetto che stai creando.

    • Seleziona il Google Cloud progetto che hai creato:

      gcloud config set project PROJECT_ID

      Sostituisci PROJECT_ID con il nome del Google Cloud progetto.

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

  12. Per accedere a Gemini Cloud Assist tramite MCP, devi far parte del programma Trusted Tester. Contatta il team dedicato all'account per richiedere l'accesso.
  13. Installa Gemini CLI.
  14. Per eseguire il deployment ed eseguire i comandi di Gemini CLI, chiedi all'amministratore di concederti i ruoli necessari all'interno del limite del progetto, come indicato nella tabella seguente:
    Attività Ruoli obbligatori
    Configura App Design Center nel tuo progetto Amministratore di App Design Center (roles/designcenter.admin)
    Accedi a Gemini Cloud Assist e chiamalo tramite MCP Amministratore di Gemini Cloud Assist (roles/geminicloudassist.admin), oppure
    Editor di Gemini Cloud Assist (roles/geminicloudassist.editor), oppure
    Utente di Gemini Cloud Assist (roles/geminicloudassist.user)

Prepara l'ambiente

Per preparare l'ambiente, esegui l'autenticazione a Google Cloud e abilita i servizi richiesti.

Esegui l'autenticazione a Google Cloud

Esegui l'autenticazione a Google Cloud eseguendo il seguente comando nel tuo terminale:

  1. Configura le Credenziali predefinite dell'applicazione per consentire ai server MCP di effettuare chiamate API.

     gcloud auth application-default login

Abilita API

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

  1. Abilita il servizio Gemini Cloud Assist nel tuo progetto:

     gcloud services enable geminicloudassist.googleapis.com

  2. 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, eseguire il deployment e risolvere i problemi dell' Google Cloud infrastruttura 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:

  1. Apri il file di configurazione di Gemini CLI in una delle seguenti posizioni:

    • Ambito utente: per applicare le impostazioni a tutti i progetti di Gemini CLI, apri ~/.gemini/settings.json.
    • Ambito area di lavoro: per applicare le impostazioni a un progetto specifico di Gemini CLI, apri .gemini/settings.json.

    Se il file di configurazione non esiste, creane uno nuovo.

  2. In settings.json, aggiungi o unisci il seguente blocco di configurazione sotto la 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.

  3. Salva e chiudi il file di configurazione.

  4. Avvia Gemini CLI.

    gemini

  5. Verifica che i server MCP siano connessi.

    /mcp list

Installa i file SKILL.md

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

Per aggiungere i file SKILL.md a Gemini CLI:

  1. Crea una directory skills/design-and-deploy in una delle seguenti posizioni:

    • Ambito utente: per applicare le impostazioni a tutti i progetti di Gemini CLI, crea ~/.gemini/skills/design-and-deploy/.
    • Ambito area di lavoro: per applicare le impostazioni a un progetto specifico di Gemini CLI, crea .gemini/skills/design-and-deploy/.

  2. Nella directory skills/design-and-deploy/, crea un file SKILL.md utilizzando i contenuti di designing-and-deploying-infrastructure.

  3. Crea una directory skills/google-gemini-cloud-assist in una delle seguenti posizioni:

    • Ambito utente: per applicare le impostazioni a tutti i progetti di Gemini CLI, crea ~/.gemini/skills/google-gemini-cloud-assist/.
    • Ambito area di lavoro: per applicare le impostazioni a un progetto specifico di Gemini CLI, crea .gemini/skills/google-gemini-cloud-assist/.

  4. Nella directory skills/google-gemini-cloud-assist/, crea un SKILL.md file utilizzando i contenuti di gestione di Google Cloud.

  5. Esci e riavvia Gemini CLI.

    /quit

    Quando riavvii Gemini CLI, il file di competenze viene rilevato automaticamente.

  6. Verifica che il file di competenze sia stato rilevato automaticamente.

    /skills list

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

Progetta la tua Google Cloud infrastruttura

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

  1. Imposta il progetto che vuoi utilizzare:

    gcloud config set project PROJECT_ID

  2. Chiedi la Google Cloud progettazione dell'infrastruttura.

     My application code is in REPOSITORY_URL. Design the Google Cloud infrastructure required for my application.

    L'agente chiede di attivare le competenze che hai configurato. L'agente crea un piano di progettazione dell'infrastruttura e ti chiede l'approvazione.

  3. Approva il piano.

    Continue with the plan.

    L'agente identifica gli strumenti da utilizzare per creare l'infrastruttura e chiede di utilizzare lo strumento setup_adc, che configura App Design Center nel tuo progetto.

  4. Consenti a Gemini Cloud Assist di utilizzare gli strumenti proposti.

    L'agente propone un progetto e ti chiede se sei pronto per il deployment.

  5. 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 iniziale dell'infrastruttura e hai eseguito l'iterazione per migliorarlo.

Valuta la conformità agli standard di sicurezza

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

  1. Assicurati che il progetto 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 il progetto 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 ti chiede l'approvazione.

  2. 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.

Il progetto dell'infrastruttura è conforme ai framework di sicurezza della tua organizzazione.

Esegui il deployment del progetto dell'infrastruttura

Esegui il deployment del progetto dell'infrastruttura su Google Cloud.

  1. Approva il progetto ed esegui il deployment.

    Deploy the infrastructure design to my Google Cloud project.

    L'agente esegue il deployment del progetto finale nel tuo Google Cloud progetto. L'agente ti chiede di approvare le modifiche al progetto. Ad esempio, potresti dover abilitare un'API.

    Se l'applicazione viene eseguita correttamente, l'agente visualizza i dettagli del deployment, i componenti dell'architettura e i passaggi per utilizzare l'applicazione.

  2. Se il deployment non riesce, richiedi 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.

  3. Per riprovare a eseguire il deployment dopo aver apportato le modifiche, ripeti i passaggi descritti in questa sezione.

Hai eseguito il deployment del codice dell'applicazione e del progetto dell'infrastruttura su Google Cloud.

Libera spazio

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.

    Elimina un Google Cloud progetto:

    gcloud projects delete PROJECT_ID

Passaggi successivi