Anwendung mit der Antigravity-CLI entwerfen und bereitstellen

Wichtig: Die Integration von Gemini Cloud Assist in Drittanbieter Tools mit MCP ist in der privaten Vorabversion verfügbar. Wenden Sie sich an Ihr Google Cloud Account-Management-Team, um Zugriff zu erhalten.

Die Nutzung dieser Vorabversion von Gemini Cloud Assist unterliegt der Google Cloud Vereinbarung, einschließlich der Pre-GA-Angebotsbedingungen der Google Cloud spezifischen Nutzungsbedingungen, die durch die Nutzungsbedingungen für das Trusted Tester-Programm von Google Cloud Gemini für ergänzt werden.

Mit den MCP-Servern (Model Context Protocol) von Gemini Cloud Assist und App Design Center können Sie die Infrastruktur direkt in der Antigravity CLI entwerfen, bereitstellen und Fehler beheben Google Cloud .

Ziele

In dieser Anleitung erfahren Sie, wie Sie Folgendes tun:

• Die Antigravity CLI für die Verwendung von MCP-Servern von Gemini Cloud Assist und App Design Center einrichten
• Infrastruktur 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. Verwenden Sie den Preisrechner.

Neuen Google Cloud Nutzern vonsteht 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 ein beliebiges Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
   • Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Projektersteller“ (roles/resourcemanager.projectCreator), die die resourcemanager.projects.create Berechtigung enthält. Rollen zuweisen.
   Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit ihm verknüpften Ressourcen entfernen.

   • Google Cloud Projekt erstellen:

     gcloud projects create PROJECT_ID

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

   • Wählen Sie das Google Cloud Projekt aus, das Sie erstellt haben:

     gcloud config set project PROJECT_ID

     Ersetzen Sie PROJECT_ID durch den Namen Ihres Google Cloud Projekts.

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

6. Wenn Sie über MCP auf Gemini Cloud Assist zugreifen möchten, müssen Sie am Trusted Tester-Programm teilnehmen. Wenden Sie sich an Ihr Account-Management-Team, um Zugriff zu erhalten.
7. Installieren Sie die Antigravity CLI
8. Wenn Sie Antigravity CLI-Befehle bereitstellen und ausführen möchten, bitten Sie Ihren Administrator, Ihnen die erforderlichen Rollen innerhalb Ihrer Projektgrenze zuzuweisen, wie in der folgenden Tabelle aufgeführt:

   Aufgabe	Erforderliche Rollen
   App Design Center in Ihrem Projekt einrichten	App Design Center Admin (roles/designcenter.admin)
   Über MCP auf Gemini Cloud Assist zugreifen und es 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 authentifizieren Google Cloud

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 von Gemini Cloud Assist und App 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

Mit den MCP Servern von Gemini Cloud Assist und App Design Center können Sie die Infrastruktur mithilfe von Prompts in natürlicher Sprache entwerfen, bewerten, bereitstellen und Fehler beheben Google Cloud. 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 Ihre 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.
   • Arbeitsbereichsbereich: Wenn Sie Einstellungen für ein bestimmtes Antigravity CLI Projekt anwenden möchten, öffnen Sie .agents/mcp_config.json.

   Wenn Ihre 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"
         }
       }
     }
   

   Diese Konfiguration verwendet automatisch Ihre Standardanmeldedaten für Anwendungen.

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-Dateien installieren

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

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

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

   • 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 Datei SKILL.md mit dem Inhalt von designing-and-deploying-infrastructure.

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

   • 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 von Google Cloud betreiben.

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

   /quit
   

   Wenn Sie die Antigravity CLI mit agy neu 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 für die Verbindung zu den MCP-Servern von App Design Center und Gemini Cloud Assist konfiguriert und Skill-Dateien erstellt.

Infrastruktur Google Cloud

Entwerfen Sie eine Infrastruktur, die für das Speichern und Ausführen Ihres Anwendungscodes geeignet ist.

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

   gcloud config set project PROJECT_ID
   

2. Fordern Sie das Google Cloud Infrastrukturdesign an.

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

   Der Agent fordert Sie auf, die konfigurierten Skills zu aktivieren. Der Agent erstellt einen Plan für das Infrastrukturdesign und bittet um Ihre Genehmigung.

3. Genehmigen Sie den Plan.

   Continue with the plan.
   

   Der Agent ermittelt die Tools, die zum Erstellen der Infrastruktur verwendet werden sollen. Der Agent fordert Sie auf, das Tool setup_adc zu verwenden, mit dem App Design Center in Ihrem Projekt eingerichtet wird.

4. Erlauben Sie Gemini Cloud Assist, die vorgeschlagenen Tools zu verwenden.

   Der 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 Agent fragt, ob Sie eine Erklärung der Änderungen oder einen Test der Änderungen wünschen.

Sie haben Ihr erstes Infrastrukturdesign erstellt und es iteriert, um es zu verbessern.

Compliance mit Sicherheitsstandards bewerten

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

1. Prüfen Sie, ob das Infrastrukturdesign den Sicherheitsstandards Ihrer Organisation entspricht.

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

   Der Agent analysiert das Infrastrukturdesign anhand der Sicherheitsframeworks, die der Administrator Ihrer Organisation in 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 Sicherheitsframeworks Ihrer Organisation.

Infrastrukturdesign bereitstellen

Stellen Sie das Infrastrukturdesign inbereit Google Cloud.

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

   Deploy the infrastructure design to my Google Cloud project.
   

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

   Wenn die Anwendung erfolgreich bereitgestellt wird, zeigt der Agent Details zur Bereitstellung, 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 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 den Änderungen noch einmal versuchen möchten, wiederholen Sie die Schritte in diesem Abschnitt.

Sie haben Ihren Anwendungscode und das Infrastrukturdesign in Google 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.

Achtung: Das Löschen von Projekten hat folgende Auswirkungen:

• Alle Inhalte des Projekts werden gelöscht. Wenn Sie für die Aufgaben in diesem Dokument ein bereits bestehendes Projekt verwendet haben und dieses löschen, werden auch alle anderen im Rahmen des Projekts erstellten Daten gelöscht.
• Benutzerdefinierte Projekt-IDs gehen verloren. Beim Erstellen dieses Projekts haben Sie möglicherweise eine benutzerdefinierte Projekt-ID erstellt, die Sie weiterhin verwenden möchten. Damit die URLs, die die Projekt-ID nutzen, z. B. eine appspot.com-URL, erhalten bleiben, sollten Sie ausgewählte Ressourcen innerhalb des Projekts löschen, statt das gesamte Projekt.

Wenn Sie mehrere Architekturen, Anleitungen und Kurzanleitungen durcharbeiten möchten, können Sie die Überschreitung von Projektkontingenten verhindern, indem Sie Projekte wiederverwenden.

Projekt Google Cloud löschen:

gcloud projects delete PROJECT_ID

Nächste Schritte

• Anwendungsstatus und ‑leistung überwachen.
• Referenzarchitekturen, Diagramme und Best Practices zu Google Cloud kennenlernen. Weitere Informationen zu Cloud Architecture Center