Anwendung mit der Antigravity-CLI entwerfen und bereitstellen

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

Ziele

In dieser Anleitung erfahren Sie, wie Sie Folgendes tun:

  • Antigravity CLI für die Verwendung von Gemini Cloud Assist- und App Design Center-MCP-Servern einrichten
  • Entwerfen und stellen Sie Google Cloud Infrastruktur bereit, 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. Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie einfach ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

  2. Installieren Sie die Google Cloud CLI.

  3. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

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

    gcloud init

  5. Google Cloud Projekt erstellen oder auswählen

    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

    • So erstellen Sie ein Google Cloud Projekt:

      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 von Ihnen erstellte Google Cloud Projekt aus:

      gcloud config set project PROJECT_ID

      Ersetzen Sie PROJECT_ID durch Ihren Google Cloud Projektnamen.

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

  7. Installieren Sie die Google Cloud CLI.

  8. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

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

    gcloud init

  10. Google Cloud Projekt erstellen oder auswählen

    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

    • So erstellen Sie ein Google Cloud Projekt:

      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 von Ihnen erstellte Google Cloud Projekt aus:

      gcloud config set project PROJECT_ID

      Ersetzen Sie PROJECT_ID durch Ihren Google Cloud Projektnamen.

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

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

Umgebung vorbereiten

Um Ihre Umgebung vorzubereiten, authentifizieren Sie sich bei Google Cloud und aktivieren Sie die erforderlichen Dienste.

Bei Google Cloudauthentifizieren

Authentifizieren Sie sich für 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 „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 CloudKonfigurieren 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.
    • Workspace-Bereich: 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"
      }
    }
  }

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

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

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 von 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 von operating-google-cloud.

  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 konfiguriert, um eine Verbindung zum App Design Center und zu den Gemini Cloud Assist-MCP-Servern herzustellen, und Skill-Dateien erstellt.

Infrastruktur Google Cloud entwerfen

Infrastruktur entwerfen, die auf die Speicherung und Ausführung Ihres Anwendungscodes zugeschnitten 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 von Ihnen konfigurierten Skills zu aktivieren. Der Agent erstellt einen Infrastrukturplan und bittet um Ihre Genehmigung.

  3. Genehmigen Sie den Plan.

    Continue with the plan.

    Der Agent identifiziert die Tools, die zum Erstellen der Infrastruktur verwendet werden sollen. Er bittet darum, das setup_adc-Tool zu verwenden, mit dem das App Design Center in Ihrem Projekt eingerichtet wird.

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

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

  5. Das vorgeschlagene Design iterieren.

    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 durch Iteration verbessert.

Einhaltung von Sicherheitsstandards bewerten

Administratoren in Ihrer Organisation haben wahrscheinlich bestimmte Sicherheitsframeworks konfiguriert, die das Design und die Bereitstellung der Infrastruktur beeinflussen. In diesem Abschnitt können Sie prüfen, 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 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 Kundenservicemitarbeiter wendet die Änderungen an und fragt, ob Sie bereit sind, das Design zu genehmigen.

Ihr Infrastrukturdesign entspricht den Sicherheitsrichtlinien 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 Agent bittet Sie, Änderungen an Ihrem Projekt zu genehmigen. Möglicherweise müssen Sie beispielsweise eine API aktivieren.

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

  2. Wenn die Bereitstellung fehlschlägt, können Sie sich Hilfe bei der Fehlerbehebung holen. 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 die Komponentenkonfigurationen und erstellt eine Differenzansicht, die Sie prüfen und akzeptieren können.

  3. Wenn Sie das Deployment 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