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

I server Model Context Protocol (MCP) di Gemini Cloud Assist e Application Design Center ti consentono di progettare, eseguire il deployment e risolvere i problemi dell'infrastrutturaGoogle Cloud direttamente nell'Antigravity CLI. Dopo aver connesso i server MCP e installato i file delle skill dell'agente, puoi generare l'infrastruttura per il codice dell'applicazione. Puoi anche valutare la conformità agli standard di sicurezza e risolvere i problemi di deployment utilizzando prompt in linguaggio naturale.

Obiettivi

Questo tutorial ti aiuta a:

  • Configura l'interfaccia a riga di comando di Antigravity 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.
  • 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 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

  1. Installa Google Cloud CLI.

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

    Per saperne di più, consulta Accedi a gcloud CLI con la tua identità federata.

  3. Per inizializzare gcloud CLI, esegui questo comando: 

    gcloud init

  4. Crea o seleziona un progetto Google Cloud .

    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 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'autorizzazione resourcemanager.projects.create. Scopri come concedere i ruoli.

    • Crea 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 .

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

  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 l'Antigravity CLI
  8. Per eseguire il deployment e i comandi dell'interfaccia a riga di comando di Antigravity, chiedi all'amministratore di concederti i ruoli necessari all'interno del confine del progetto, come elencato nella tabella seguente:
    Attività Ruoli obbligatori
    Configura App Design Center nel tuo progetto Application Design Center Admin (roles/designcenter.admin)
    Accedi e chiama Gemini Cloud Assist tramite MCP Gemini Cloud Assist Admin (roles/geminicloudassist.admin) o
    Gemini Cloud Assist Editor (roles/geminicloudassist.editor) o
    Gemini Cloud Assist User (roles/geminicloudassist.user)

Prepara l'ambiente

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

Esegui l'autenticazione su Google Cloud

Esegui l'autenticazione su Google Cloud eseguendo questo comando nel 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 Application 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'infrastruttura Google Cloudutilizzando 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, segui questi passaggi:

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

    • Ambito utente: per applicare le impostazioni a tutti i tuoi progetti Antigravity CLI, apri ~/.gemini/config/mcp_config.json.
    • Ambito dell'area di lavoro: per applicare le impostazioni per un progetto Antigravity CLI specifico, 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 tue Credenziali predefinite dell'applicazione.

  3. Salva e chiudi il file di configurazione.

  4. Avvia l'interfaccia a riga di comando di Antigravity.

    agy

  5. Verifica che i server MCP siano connessi.

    /mcp list

Installa SKILL.md file

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

Per aggiungere file SKILL.md all'interfravity CLI, segui questi passaggi:

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

    • Ambito utente: per applicare le impostazioni a tutti i tuoi progetti Antigravity CLI, crea ~/.gemini/config/skills/design-and-deploy/.
    • Ambito dell'area di lavoro: per applicare le impostazioni a un progetto Antigravity CLI specifico, 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 tuoi progetti Antigravity CLI, crea ~/.gemini/config/skills/google-gemini-cloud-assist/.
    • Ambito dell'area di lavoro: per applicare le impostazioni a un progetto Antigravity CLI specifico, crea .agents/skills/google-gemini-cloud-assist/.

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

  5. Esci e riavvia la sessione di Antigravity CLI.

    /quit

    Quando riavvii Antigravity CLI con agy, i file delle skill vengono rilevati automaticamente.

  6. Verifica che i file delle skill siano stati rilevati automaticamente.

    /skills list

Hai configurato correttamente Antigravity CLI per connetterti ai server MCP di App Design Center e Gemini Cloud Assist e hai creato i file delle skill.

Progetta la tua infrastruttura Google Cloud

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

  1. Imposta il progetto che vuoi utilizzare:

    gcloud config set project PROJECT_ID

  2. Chiedi il Google Cloud progetto dell'infrastruttura.

     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.

  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 design e ti chiede se vuoi procedere con il deployment.

  5. Esegui l'iterazione del progetto proposto.

    The infrastructure looks good, but I want to add a cache for frequently accessed data.

    L'agente aggiorna il design 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

È probabile che gli amministratori della tua organizzazione abbiano 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 design 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 design 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 vuoi approvare il design.

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

Esegui il deployment del design dell'infrastruttura

Esegui il deployment del design dell'infrastruttura in Google Cloud.

  1. Approva il design ed esegui il deployment.

    Deploy the infrastructure design to my Google Cloud project.

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

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

  2. 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 di Identity and Access Management (IAM).

    Fix the component configuration errors.

    L'agente fornisce suggerimenti per le configurazioni dei componenti e crea una visualizzazione delle differenze che puoi esaminare e accettare.

  3. 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 del design dell'infrastruttura inGoogle 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.

    Elimina un progetto Google Cloud :

    gcloud projects delete PROJECT_ID

Passaggi successivi