Progetta ed esegui il deployment di un'applicazione utilizzando Antigravity 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 Google Cloud dell'infrastruttura direttamente in Antigravity CLI.

Obiettivi

Questo tutorial ti aiuta a:

  • Configurare Antigravity 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. Installa Google Cloud CLI.

  2. Configura gcloud CLI per utilizzare la tua identità federata.

    Per ulteriori informazioni, vedi Accedi a gcloud CLI con la tua identità federata.

  3. Per inizializzare gcloud CLI, esegui questo comando: 

    gcloud init

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

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

  6. Per accedere a Gemini Cloud Assist tramite MCP, devi partecipare al programma Trusted Tester. Contatta il team dedicato all'account per richiedere l'accesso.
  7. Installa la Antigravity CLI
  8. Per eseguire il deployment ed eseguire i comandi di Antigravity 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), o
    Editor di Gemini Cloud Assist (roles/geminicloudassist.editor), o
    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 questo 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 Antigravity.

Per configurare Antigravity CLI in modo che utilizzi i server MCP:

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

    • Ambito utente: per applicare le impostazioni a tutti i progetti di Antigravity CLI, apri ~/.gemini/config/mcp_config.json.
    • Ambito spazio di lavoro: per applicare le impostazioni a un progetto specifico di Antigravity CLI progetto, apri .agents/mcp_config.json.

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

  2. In mcp_config.json, aggiungi o unisci il seguente blocco di configurazione sotto la chiave mcpServers.

      {
    "mcpServers": {
      "gemini-cloud-assist": {
        "serverUrl": "https://geminicloudassist.googleapis.com/mcp",
        "authProviderType": "google_credentials"
      },
      "application-design-center": {
        "serverUrl": "https://designcenter.googleapis.com/mcp",
        "authProviderType": "google_credentials"
      }
    }
  }

    Questa configurazione utilizza automaticamente le Credenziali predefinite dell'applicazione.

  3. Salva e chiudi il file di configurazione.

  4. Avvia Antigravity CLI.

    agy

  5. Verifica che i server MCP siano connessi.

    /mcp list

Installa i file SKILL.md

I file SKILL.md forniscono le istruzioni e i workflow 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 ad Antigravity 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 Antigravity CLI, crea ~/.gemini/config/skills/design-and-deploy/.
    • Ambito spazio di lavoro: per applicare le impostazioni a un progetto specifico di Antigravity CLI progetto, crea .agents/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 Antigravity CLI, crea ~/.gemini/config/skills/google-gemini-cloud-assist/.
    • Ambito spazio di lavoro: per applicare le impostazioni a un progetto specifico di Antigravity CLI progetto, crea .agents/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 la sessione di Antigravity CLI.

    /quit

    Quando riavvii Antigravity CLI con agy, i file di competenze vengono rilevati automaticamente.

  6. Verifica che i file di competenze siano stati rilevati automaticamente.

    /skills list

Hai configurato correttamente Antigravity 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. Richiedi la progettazione dell' Google Cloud 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 chiede la tua 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 chiede la tua 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 tuo progetto. Ad esempio, potresti dover abilitare un'API.

    Se l'applicazione viene eseguita correttamente, l'agente mostra 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