Anwendung mit der Gemini CLI und CI/CD-Skills bereitstellen

1. Einführung

In diesem Codelab lernen Sie den „Zero-to-Hero“-Workflow für Platform Engineering mit der Gemini CLI und der CI/CD-Erweiterung kennen. Sie schlüpfen in die Rolle eines Unternehmensentwicklers, der eine Anwendung (z. B. die Spring Petclinic-Demo oder eine Python Flask-App) erstellt hat und sie jetzt in Google Cloud bereitstellen möchte, um sie zu teilen.

Statt komplexe Pipelines manuell zu konfigurieren, können Sie Gemini mit natürlicher Sprache anleiten. Der Agent analysiert Ihr Projekt, schlägt kleine Ziel-Runtimes wie Google Cloud Run vor, führt Sicherheitsscans auf durchgesickerte vertrauliche Daten durch und übernimmt die Bereitstellung. Sie erhalten eine funktionierende URL.

Aufgaben

  • Klonen Sie ein Repository. Sie können Ihr eigenes oder eine Demo-App wie Spring Petclinic verwenden.
  • Installieren und konfigurieren Sie die Gemini CLI und die CI/CD-Erweiterung.
  • Verwenden Sie einen Prompt wie deploy my application, um den Bereitstellungs-Skill auszulösen.
  • Sehen Sie zu, wie Gemini das Projekt analysiert, Cloud Run vorschlägt, Sicherheitsprüfungen durchführt und die Anwendung bereitstellt.
  • Prüfen Sie, ob die Anwendung ausgeführt wird.

Voraussetzungen

  • Ein Webbrowser wie Chrome.
  • Google Cloud-Projekt mit aktivierter Abrechnungsfunktion.

Dieses Codelab richtet sich an Entwickler aller Erfahrungsstufen, auch an Anfänger.

2. Hinweis

Abrechnung einrichten

Ein Google Cloud-Projekt erstellen oder auswählen

Google Cloud-Projekt erstellen

  1. Wählen Sie in der Google Cloud Console auf der Seite zur Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.
  2. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.

Cloud Shell starten

Cloud Shell ist eine Befehlszeilenumgebung, die in Google Cloud ausgeführt wird und mit den erforderlichen Tools vorinstalliert ist.

  1. Klicken Sie oben in der Google Cloud Console auf Cloud Shell aktivieren.
  2. Prüfen Sie nach der Verbindung mit Cloud Shell Ihre Authentifizierung:
    gcloud auth list
  3. Prüfen Sie, ob Ihr Projekt konfiguriert ist:
    gcloud config get project
  4. Wenn Ihr Projekt nicht wie erwartet festgelegt ist, legen Sie es fest:
    export PROJECT_ID=<YOUR_PROJECT_ID>
gcloud config set project $PROJECT_ID

APIs aktivieren

Führen Sie diesen Befehl in Cloud Shell aus, um alle für dieses Lab erforderlichen APIs zu aktivieren:

gcloud services enable \
  cloudbuild.googleapis.com \
  run.googleapis.com \
  artifactregistry.googleapis.com

3. Gemini CLI einrichten

In diesem Schritt installieren und konfigurieren Sie die Gemini CLI und die CI/CD-Erweiterung.

  1. Prüfen, ob die Gemini CLI installiert ist Wenn Sie die Gemini CLI noch nicht installiert haben, folgen Sie der Anleitung im Gemini CLI-Leitfaden für den Einstieg.
  2. Anmelden: Wir empfehlen, sich mit Ihrem Google-Konto anzumelden. Weitere Informationen finden Sie im Authentifizierungsleitfaden.
  3. CI/CD-Erweiterung installieren: Führen Sie den folgenden Befehl aus, um die Erweiterung von GitHub zu installieren:
    gemini extensions install https://github.com/gemini-cli-extensions/cicd
    Sie können die Installation von Erweiterungen überprüfen, indem Sie die installierten Erweiterungen auflisten:
    gemini extensions list
  4. Standardanmeldedaten für Anwendungen konfigurieren: Für die CI/CD-Erweiterung müssen Standardanmeldedaten für Anwendungen konfiguriert sein. Ausführen:
    gcloud auth login
gcloud auth application-default login
  5. Standardprojekt und ‑region festlegen: Es ist hilfreich, gcloud mit einem Standardprojekt und einem Kontingentprojekt für ADC konfiguriert zu haben. Ersetzen Sie durch Ihre tatsächlichen Werte (z.B. my-project):
    gcloud config set project <PROJECT_ID>
gcloud auth application-default set-quota-project <PROJECT_ID>

4. Anwendung bereitstellen

Jetzt können Sie die Gemini CLI und die CI/CD-Erweiterung verwenden, um die Anwendung bereitzustellen.

Repository klonen

In diesem Lab verwenden wir die beliebte Beispielanwendung Spring Petclinic. Sie können auch Ihre eigene Anwendung verwenden, wenn Sie eine haben, die eine unterstützte Laufzeit (z. B. Python/Flask, Java/Spring Boot) nutzt.

  1. Klonen Sie das Repository und wechseln Sie in das Verzeichnis: 
    git clone https://github.com/spring-projects/spring-petclinic.git
cd spring-petclinic

Gemini auffordern, die Bereitstellung durchzuführen

  1. Starten Sie die Gemini CLI über das Projektverzeichnis:
    gemini
  2. Verwenden Sie in der Gemini CLI-Shell die CI/CD-Erweiterung, um Ihre Anwendung bereitzustellen. Sie können einen einfachen Prompt in natürlicher Sprache verwenden:
    deploy my application

Was passiert als Nächstes?

Gemini aktiviert den google-cicd-deploy-Skill und führt mehrere Aktionen aus:

  • Projekt analysieren: Dadurch wird der Anwendungstyp ermittelt (z.B. Spring Boot).
  • Laufzeit vorschlagen: Es wird eine geeignete Laufzeit wie Google Cloud Run vorgeschlagen.
  • Sicherheitsscan: Mit den MCP-Tools wird nach offengelegten Secrets gesucht. Sie sollten die Ausführung der Tools zulassen, wenn Sie dazu aufgefordert werden.
  • Konfiguration extrahieren: gcloud wird verwendet, um die Umgebung Ihres aktuellen Projekts zu lesen.
  • Parameter vorschlagen: Es werden sinnvolle Standardwerte für Bereitstellungsparameter angezeigt und Sie werden um Bestätigung gebeten.

Prüfen Sie die vorgeschlagene Konfiguration und bestätigen Sie die Bereitstellung.

Anschließend erhalten Sie von Gemini die URL Ihrer ausgeführten Anwendung.

5. Bereinigen

Löschen Sie die in diesem Codelab erstellten Ressourcen, um laufende Gebühren für Ihr Google Cloud-Konto zu vermeiden.

Wenn Sie die Bereitstellung in Cloud Run vorgenommen haben, können Sie den Dienst mit dem folgenden Befehl löschen. Ersetzen Sie durch Ihre Compute-Region, z. B. us-central1:

gcloud run services delete spring-petclinic --region <REGION>

Wenn Sie für dieses Codelab ein eigenes Projekt erstellt haben, können Sie das gesamte Projekt löschen:

gcloud projects delete <YOUR_PROJECT_ID>

6. Glückwunsch

Glückwunsch! Sie haben die Gemini CLI und die CI/CD-Erweiterung erfolgreich verwendet, um eine Anwendung mit Prompts in natürlicher Sprache in Google Cloud Run bereitzustellen.

Das haben Sie gelernt

  • So installieren und konfigurieren Sie die Gemini CLI und die CI/CD-Erweiterung.
  • So lösen Sie einen Bereitstellungsablauf mit natürlicher Sprache aus.
  • Wie Gemini Ihr Projekt analysiert, Sicherheitsprüfungen durchführt und Laufzeiten vorschlägt.

Nächste Schritte

Referenzdokumente