Anwendung mit der Antigravity-CLI entwerfen und bereitstellen

Mit den MCP-Servern (Model Context Protocol) von Gemini Cloud Assist und Application Design Center können SieGoogle Cloud -Infrastruktur direkt in der Antigravity CLI entwerfen, bereitstellen und Fehler beheben. Nachdem Sie die MCP-Server verbunden und die Agent-Skill-Dateien installiert haben, können Sie die Infrastruktur für Ihren Anwendungscode generieren. Außerdem können Sie die Einhaltung von Sicherheitsstandards bewerten und Bereitstellungsprobleme mithilfe von Prompts in natürlicher Sprache beheben.

Ziele

In dieser Anleitung wird Folgendes beschrieben:

  • Richten Sie die Antigravity CLI so ein, dass sie die MCP-Server von Gemini Cloud Assist und App Design Center verwendet.
  • Infrastruktur in Google Cloud entwerfen und bereitstellen, die für die Ausführung Ihres vorhandenen Anwendungscodes optimiert ist.
  • Technische Probleme analysieren und beheben.

Kosten

In diesem Dokument verwenden Sie die folgenden kostenpflichtigen Komponenten von Google Cloud:

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

Mit dem Preisrechner können Sie eine Kostenschätzung für Ihre voraussichtliche Nutzung vornehmen.

Neuen Nutzern von Google Cloud steht möglicherweise eine kostenlose Testversion zur Verfügung.

Nach Abschluss der in diesem Dokument beschriebenen Aufgaben können Sie weitere Kosten vermeiden, indem Sie die erstellten Ressourcen löschen. Weitere Informationen finden Sie unter Bereinigen.

Hinweis

  1. Installieren Sie die Google Cloud CLI.

  2. Konfigurieren Sie die gcloud CLI für die Verwendung Ihrer föderierten Identität.

    Weitere Informationen finden Sie unter Mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  3. Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren: 

    gcloud init

  4. Erstellen oder wählen Sie ein Google Cloud -Projekt aus.

    Erforderliche Rollen zum Auswählen oder Erstellen eines Projekts

    • Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können jedes Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
    • Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Project Creator“ (roles/resourcemanager.projectCreator), die die Berechtigung resourcemanager.projects.create enthält. Informationen zum Zuweisen von Rollen

    • Erstellen Sie ein Projekt in Google Cloud :

      gcloud projects create PROJECT_ID

      Ersetzen Sie PROJECT_ID durch einen Namen für das Projekt in Google Cloud , das Sie erstellen.

    • Wählen Sie das von Ihnen erstellte Projekt Google Cloud aus:

      gcloud config set project PROJECT_ID

      Ersetzen Sie PROJECT_ID durch den Namen Ihres Projekts in Google Cloud .

  5. Prüfen Sie, ob die Abrechnung für Ihr Google Cloud -Projekt aktiviert ist.

  6. Um über MCP auf Gemini Cloud Assist zugreifen zu können, müssen Sie am Trusted Tester-Programm teilnehmen. Wenden Sie sich an Ihr Account-Management-Team, um Zugriff anzufordern.
  7. Antigravity CLI installieren
  8. Bitten Sie Ihren Administrator, Ihnen die erforderlichen Rollen innerhalb Ihrer Projektgrenze zuzuweisen, wie in der folgenden Tabelle aufgeführt, um Antigravity-CLI-Befehle bereitzustellen und auszuführen:
    Aufgabe Erforderliche Rollen
    App Design Center in Ihrem Projekt einrichten Application Design Center Admin (roles/designcenter.admin)
    Über MCP auf Gemini Cloud Assist zugreifen und aufrufen Gemini Cloud Assist Admin (roles/geminicloudassist.admin) oder
    Gemini Cloud Assist Editor (roles/geminicloudassist.editor) oder
    Gemini Cloud Assist User (roles/geminicloudassist.user)

Umgebung vorbereiten

Authentifizieren Sie sich bei Google Cloud und aktivieren Sie die erforderlichen Dienste, um Ihre Umgebung vorzubereiten.

Bei Google Cloudauthentifizieren

Authentifizieren Sie sich bei Google Cloud , indem Sie den folgenden Befehl in Ihrem Terminal ausführen:

  1. Richten Sie Standardanmeldedaten für Anwendungen ein, damit die MCP-Server API-Aufrufe ausführen können.

     gcloud auth application-default login

APIs aktivieren

Aktivieren Sie die Dienste Gemini Cloud Assist und Application Design Center in Ihrem Projekt.

  1. Aktivieren Sie den Gemini Cloud Assist-Dienst in Ihrem Projekt:

     gcloud services enable geminicloudassist.googleapis.com

  2. Aktivieren Sie den App Design Center-Dienst in Ihrem Projekt:

     gcloud services enable designcenter.googleapis.com

MCP-Server konfigurieren

Die MCP-Server von Gemini Cloud Assist und App Design Center unterstützen Sie beim Entwerfen, Bewerten, Bereitstellen und Beheben von Fehlern in der Google Cloud-Infrastruktur mithilfe von Prompts in natürlicher Sprache. Konfigurieren Sie Ihre Antigravity-Einstellungen, um eine Verbindung zu den MCP-Servern herzustellen.

So konfigurieren Sie die Antigravity CLI für die Verwendung von MCP-Servern:

  1. Öffnen Sie die MCP-Konfigurationsdatei an einem der folgenden Speicherorte:

    • Nutzerbereich: Wenn Sie Einstellungen auf alle Ihre Antigravity CLI-Projekte anwenden möchten, öffnen Sie ~/.gemini/config/mcp_config.json.
    • Arbeitsbereich: Wenn Sie Einstellungen für ein bestimmtes Antigravity CLI-Projekt anwenden möchten, öffnen Sie .agents/mcp_config.json.

    Wenn die Konfigurationsdatei nicht vorhanden ist, erstellen Sie eine neue Datei.

  2. Fügen Sie in mcp_config.json den folgenden Konfigurationsblock unter dem Schlüssel mcpServers hinzu oder führen Sie ihn zusammen.

      {
    "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"
      }
    }
  }

    Bei dieser Konfiguration werden automatisch Ihre Standardanmeldedaten für Anwendungen verwendet.

  3. Speichern und schließen Sie die Konfigurationsdatei.

  4. Starten Sie die Antigravity CLI.

    agy

  5. Prüfen Sie, ob die MCP-Server verbunden sind.

    /mcp list

SKILL.md Datei installieren

SKILL.md-Dateien enthalten Anleitungen und Workflows für die MCP-Server von App Design Center und Gemini Cloud Assist für das Infrastrukturdesign, die Bereitstellung und die Fehlerbehebung.

So fügen Sie der Antigravity CLI SKILL.md-Dateien hinzu:

  1. Erstellen Sie ein skills/design-and-deploy-Verzeichnis an einem der folgenden Speicherorte:

    • Nutzerbereich: Wenn Sie Einstellungen auf alle Ihre Antigravity CLI-Projekte anwenden möchten, erstellen Sie ~/.gemini/config/skills/design-and-deploy/.
    • Arbeitsbereichsbereich: Wenn Sie Einstellungen für ein bestimmtes Antigravity CLI-Projekt anwenden möchten, erstellen Sie .agents/skills/design-and-deploy/.

  2. Erstellen Sie im Verzeichnis skills/design-and-deploy/ eine SKILL.md-Datei mit dem Inhalt aus designing-and-deploying-infrastructure.

  3. Erstellen Sie ein skills/google-gemini-cloud-assist-Verzeichnis an einem der folgenden Speicherorte:

    • Nutzerbereich: Wenn Sie Einstellungen auf alle Ihre Antigravity CLI-Projekte anwenden möchten, erstellen Sie ~/.gemini/config/skills/google-gemini-cloud-assist/.
    • Arbeitsbereichsbereich: Wenn Sie Einstellungen für ein bestimmtes Antigravity-CLI-Projekt anwenden möchten, erstellen Sie .agents/skills/google-gemini-cloud-assist/.

  4. Erstellen Sie im Verzeichnis skills/google-gemini-cloud-assist/ eine SKILL.md-Datei mit dem Inhalt aus operating-google-cloud.

  5. Beenden Sie die Antigravity CLI-Sitzung und starten Sie sie neu.

    /quit

    Wenn Sie die Antigravity CLI noch einmal mit agy starten, werden Ihre Skill-Dateien automatisch erkannt.

  6. Prüfen Sie, ob die Skill-Dateien automatisch erkannt wurden.

    /skills list

Sie haben die Antigravity CLI erfolgreich so konfiguriert, dass sie eine Verbindung zu den MCP-Servern für das App Design Center und Gemini Cloud Assist herstellt, und Skill-Dateien erstellt.

Google Cloud -Infrastruktur entwerfen

Infrastruktur entwerfen, die auf das Speichern und Ausführen Ihres Anwendungscodes zugeschnitten ist

  1. Legen Sie das Projekt fest, das Sie verwenden möchten:

    gcloud config set project PROJECT_ID

  2. Fragen Sie nach dem Infrastrukturdesign von Google Cloud .

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

    Der Agent bittet darum, die von Ihnen konfigurierten Skills zu aktivieren. Der KI-Agent erstellt einen Infrastruktur-Designplan und bittet um Ihre Genehmigung.

  3. Genehmigen Sie den Plan.

    Continue with the plan.

    Der KI-Agent identifiziert Tools, die zum Erstellen der Infrastruktur verwendet werden sollen. Er bittet um die Verwendung des setup_adc-Tools, mit dem das App Design Center in Ihrem Projekt eingerichtet wird.

  4. Gemini Cloud Assist erlauben, die vorgeschlagenen Tools zu verwenden.

    Der KI-Agent schlägt ein Design vor und fragt, ob Sie bereit sind, es bereitzustellen.

  5. Iterieren Sie das vorgeschlagene Design.

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

    Der Agent aktualisiert das Design, um Ihre Anforderung zu berücksichtigen. Der KI-Agent fragt, ob Sie eine Erklärung der Änderungen oder die Änderungen testen möchten.

Sie haben Ihren ersten Infrastrukturentwurf erstellt und ihn iterativ verbessert.

Einhaltung von Sicherheitsstandards bewerten

Administratoren in Ihrer Organisation haben wahrscheinlich bestimmte Sicherheitsframeworks konfiguriert, die das Infrastrukturdesign und die Bereitstellung beeinflussen. In diesem Abschnitt prüfen Sie, ob Ihr Design den konfigurierten Sicherheitsstandards entspricht.

  1. Achten Sie darauf, dass das Infrastrukturdesign den Sicherheitsstandards Ihrer Organisation entspricht.

    I want to make sure that infrastructure design is compliant with my organization's security standards.

    Der KI-Agent analysiert das Infrastrukturdesign anhand der Sicherheits-Frameworks, die der Administrator Ihrer Organisation im Security Command Center angegeben hat. Wenn bei der Prüfung Compliance-Probleme festgestellt werden, schlägt der Agent Sicherheitsverbesserungen vor und bittet um Ihre Genehmigung.

  2. Empfohlene Sicherheitsverbesserungen anwenden

    Apply the recommended security enhancements.

    Der Agent wendet die Änderungen an und fragt, ob Sie bereit sind, das Design zu genehmigen.

Ihr Infrastrukturdesign entspricht den Sicherheits-Frameworks Ihrer Organisation.

Infrastrukturdesign bereitstellen

Stellen Sie das Infrastrukturdesign in Google Cloudbereit.

  1. Genehmigen Sie das Design und stellen Sie es bereit.

    Deploy the infrastructure design to my Google Cloud project.

    Der KI-Agent stellt das endgültige Design in Ihrem Google Cloud -Projekt bereit. Der KI-Agent bittet Sie, Änderungen an Ihrem Projekt zu genehmigen. Möglicherweise müssen Sie beispielsweise eine API aktivieren.

    Wenn die Anwendung erfolgreich bereitgestellt wurde, zeigt der KI-Agent Bereitstellungsdetails, Architekturkomponenten und Schritte zur Verwendung der Anwendung an.

  2. Wenn die Bereitstellung fehlschlägt, erhalten Sie Hilfe bei der Fehlerbehebung. Möglicherweise müssen Sie beispielsweise Details zur Komponentenkonfiguration oder IAM-Berechtigungen (Identity and Access Management) korrigieren.

    Fix the component configuration errors.

    Der KI-Agent gibt Empfehlungen für Komponentenkonfigurationen und erstellt eine Diff-Ansicht, die Sie prüfen und akzeptieren können.

  3. Wenn Sie die Bereitstellung nach Änderungen noch einmal versuchen möchten, wiederholen Sie die Schritte in diesem Abschnitt.

Sie haben Ihren Anwendungscode und das Infrastrukturdesign inGoogle Cloudbereitgestellt.

Bereinigen

Damit Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen nicht in Rechnung gestellt werden, löschen Sie entweder das Projekt, das die Ressourcen enthält, oder Sie behalten das Projekt und löschen die einzelnen Ressourcen.

    Google Cloud -Projekt löschen:

    gcloud projects delete PROJECT_ID

Nächste Schritte