Mit dem gcloud-Tool Anwendungen testen und Indexe verwalten
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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:
Lokale Unterstützung für eine Datastore-Instanz erstellen, einschließlich Verzeichnis, erforderlicher Dateien und Projekt-ID.
Den Datastore-Emulator starten. Dieser emuliert lokal die Datastore-Produktionsumgebung.
Indexdefinitionen durch Abfragen Ihrer Anwendung an den Emulator generieren.
Manuell erstellte oder generierte Indexdefinitionen in die Produktionsinstanz der Datenbank hochladen.
Nicht verwendete Indexe aus der Produktionsinstanz der Datenbank löschen.
Entwicklungsworkflow mit dem Befehlszeilentool
Der typische Workflow mit der gcloud CLI sieht so aus:
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.
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:
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.
Umgebungsvariablen entfernen, damit Ihre Anwendung erkennt, dass sie die Produktionsinstanz der Datenbank benutzt.
Die Anwendung auf der Produktionsinstanz der Datenbank ausführen.
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:
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.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-19 (UTC)."],[[["\u003cp\u003eThe Google Cloud CLI can be used to test applications locally and manage indexes for production Firestore in Datastore mode instances.\u003c/p\u003e\n"],["\u003cp\u003eThe typical workflow involves creating local support, starting the Datastore emulator, and generating index definitions from application queries.\u003c/p\u003e\n"],["\u003cp\u003eGenerated or manually created index definitions can be uploaded to the production database instance using the \u003ccode\u003eindexes create\u003c/code\u003e command.\u003c/p\u003e\n"],["\u003cp\u003eUnused indexes can be removed from the production database instance by modifying the local \u003ccode\u003eindex.yaml\u003c/code\u003e file and using the \u003ccode\u003eindexes cleanup\u003c/code\u003e command.\u003c/p\u003e\n"],["\u003cp\u003eSetting and removing environment variables allows the application to switch between using the emulator and the production database instance.\u003c/p\u003e\n"]]],[],null,["# Using the gcloud Tool to Test Applications and Manage Indexes\n\nYou can use the Google Cloud CLI to test your application locally and\nto manage indexes for your production Firestore in Datastore mode instance. This page\ndescribes the typical workflow for these activities.\n| **Note:** This discussion assumes that you have already [enabled](/datastore/docs/activate) the Datastore API for your project; [downloaded](/sdk) the Google Cloud CLI, which contains the gcloud CLI; and set up the gcloud CLI using [`gcloud init`](/sdk/gcloud/reference/init).\n\nThe gcloud CLI supports the following workflow:\n\n1. Create local support for a Datastore instance, including directory, required files, and project ID.\n2. Start up the Datastore emulator, which provides local emulation of the production Datastore environment.\n3. Generate index definitions from your application's queries to the emulator.\n4. Upload manually created or generated index definitions to your production database instance.\n5. Delete unused indexes from your production database instance.\n\nThe development workflow using the command-line tool\n----------------------------------------------------\n\nThe following is the typical workflow using the gcloud CLI:\n\n1. [Start the Datastore emulator](/datastore/docs/tools/datastore-emulator#starting_the_emulator).\n\n2. [Set environment variables](/datastore/docs/tools/datastore-emulator#setting_environment_variables) so your application knows it is using the\n emulator.\n\n3. Start your application and test it against the emulator. You need to run the\n queries your application uses against the emulator in order to generate indexes\n for your production database instance.\n\n4. Upload the generated indexes with the [`indexes create`](/sdk/gcloud/reference/datastore/indexes/create) command, passing\n in the path to your local `index.yaml` file, as in the following example:\n\n gcloud datastore indexes create ~/.config/gcloud/emulators/datastore/WEB-INF/index.yaml\n\n The example path assumes you have not set a specific directory for the\n [`data-dir`](/sdk/gcloud/reference/beta/emulators/datastore/start#FLAGS) option. If you have set a specific directory, modify the\n path to use the path to your `index.yaml` file.\n5. [Remove environment variables](/datastore/docs/tools/datastore-emulator#removing_environment_variables) so your application knows it is using the\n production database instance.\n\n6. Run your application against your production database\n instance.\n\n7. Over time, you might no longer use some of the indexes. You can delete\n unused indexes from your production database instance by\n removing them from your local `index.yaml` file and then invoking the\n [`indexes cleanup`](/sdk/gcloud/reference/datastore/indexes/cleanup) command:\n\n gcloud datastore indexes cleanup ~/.config/gcloud/emulators/datastore/WEB-INF/index.yaml\n\n If you have set a specific directory for the [`data-dir`](/sdk/gcloud/reference/beta/emulators/datastore/start#FLAGS) option, modify the\n path in the example to use the path to your `index.yaml` file.\n\nWhat's next\n-----------\n\n- Learn more about the [emulator](/datastore/docs/tools/datastore-emulator).\n- Get details about [Index configuration](/datastore/docs/tools/indexconfig)."]]
