Vous pouvez utiliser la Google Cloud CLI pour tester votre application en local pour gérer les index de votre instance de production Firestore en mode Datastore. Cette page décrit le workflow type permettant de réaliser ces activités.
La gcloud CLI est compatible avec le workflow suivant:
- Créez un environnement compatible local pour une instance Datastore, y compris un répertoire ainsi que les fichiers requis et l'ID de projet.
- Lancez l'émulateur Datastore, qui fournit une émulation locale de l'environnement Datastore de production.
- Générez des définitions d'index à partir des requêtes depuis votre application vers l'émulateur.
- Importez des définitions d'index créées ou générées manuellement vers votre instance de base de données de production.
- Supprimez les index inutilisés de votre instance de base de données de production.
Processus de développement à l'aide de l'outil de ligne de commande
Voici le workflow type exécuté à l'aide de la CLI gcloud :
Définissez les variables d'environnement pour indiquer à votre application qu'elle utilise l'émulateur.
Démarrez votre application et testez-la par rapport à l'émulateur. Vous devez exécuter les requêtes que votre application utilise sur l'émulateur afin de générer des index pour votre instance de base de données de production.
Importez les index générés à l'aide de la commande
indexes create
pour transmettre le chemin d'accès au fichierindex.yaml
local, comme dans l'exemple suivant :gcloud datastore indexes create ~/.config/gcloud/emulators/datastore/WEB-INF/index.yaml
L'exemple de chemin d'accès suppose que vous n'avez pas défini de répertoire spécifique pour l'option
data-dir
. Si vous avez défini un répertoire spécifique, remplacez le chemin d'accès par celui de votre fichierindex.yaml
.Supprimez les variables d'environnement pour indiquer à votre application qu'elle utilise l'instance de base de données de production.
Exécutez votre application sur votre instance de base de données de production.
Avec le temps, vous êtes susceptible de ne plus utiliser certains index. Vous pouvez supprimer des index inutilisés de votre instance de base de données de production en les supprimant de votre fichier
index.yaml
local, puis en exécutant la commandeindexes cleanup
:gcloud datastore indexes cleanup ~/.config/gcloud/emulators/datastore/WEB-INF/index.yaml
Si vous avez défini un répertoire spécifique pour l'option
data-dir
, remplacez le chemin d'accès de l'exemple par celui de votre fichierindex.yaml
.
Étape suivante
- Découvrez de plus amples informations sur l'émulateur.
- Découvrez de plus amples informations sur la configuration de l'index.