Mit dem gcloud-Tool Anwendungen testen und Indexe verwalten

Sie können die Google Cloud CLI verwenden, um Ihre Anwendung lokal zu testen und die Indexe Ihrer Produktionsinstanz in Firestore im Datastore-Modus zu verwalten. Auf dieser Seite wird der typische Ablauf für diese Aktivitäten beschrieben.

Die gcloud CLI unterstützt folgenden Ablauf:

  1. Lokale Unterstützung für eine Datastore-Instanz erstellen, einschließlich Verzeichnis, erforderlicher Dateien und Projekt-ID.
  2. Den Datastore-Emulator starten. Dieser emuliert lokal die Datastore-Produktionsumgebung.
  3. Indexdefinitionen durch Abfragen Ihrer Anwendung an den Emulator generieren.
  4. Manuell erstellte oder generierte Indexdefinitionen in die Produktionsinstanz der Datenbank hochladen.
  5. Nicht verwendete Indexe aus der Produktionsinstanz der Datenbank löschen.

Entwicklungsworkflow mit dem Befehlszeilentool

Der typische Workflow mit der gcloud CLI sieht so aus:

  1. Den Datastore-Emulator starten.

  2. Umgebungsvariablen festlegen, sodass Ihre Anwendung erkennt, dass sie den Emulator benutzt.

  3. Die Anwendung starten und gegen den Emulator testen. Führen Sie die Abfragen für die Anwendung mit dem Emulator aus, damit die Indexe für die Produktionsinstanz der Datenbank erzeugt werden.

  4. Die erstellten Indexe mit dem Befehl indexes create hochladen. Dabei muss der Pfad wie im folgenden Beispiel an Ihre lokale Datei index.yaml übergeben werden:

    gcloud datastore indexes create ~/.config/gcloud/emulators/datastore/WEB-INF/index.yaml

    Bei dem Pfad im Beispiel wird angenommen, dass Sie kein bestimmtes Verzeichnis für die Option data-dir festgelegt haben. Wenn Sie ein bestimmtes Verzeichnis festgelegt haben, ändern Sie den Pfad so, dass der Pfad zu Ihrer Datei index.yaml verwendet wird.

  5. Umgebungsvariablen entfernen, damit Ihre Anwendung erkennt, dass sie die Produktionsinstanz der Datenbank benutzt.

  6. Die Anwendung auf der Produktionsinstanz der Datenbank ausführen.

  7. Im Laufe der Zeit benutzen Sie einige der Indexe möglicherweise nicht mehr. Sie können nicht verwendete Indexe aus Ihrer Produktionsinstanz der Datenbank entfernen. Löschen Sie dazu diese Indexe aus Ihrer lokalen Datei index.yaml und rufen Sie dann den Befehl indexes cleanup auf:

    gcloud datastore indexes cleanup ~/.config/gcloud/emulators/datastore/WEB-INF/index.yaml

    Wenn Sie ein bestimmtes Verzeichnis für die Option data-dir festgelegt haben, ändern Sie den Pfad aus dem Beispiel entsprechend, sodass der Pfad zu Ihrer Datei index.yaml verwendet wird.

Nächste Schritte