Tester des applications et gérer des index à l'aide de l'outil gcloud

Vous pouvez utiliser l'outil de ligne de commande gcloud pour tester votre application localement et pour gérer les index de votre production Cloud Firestore en mode Datastore. Cette page décrit le flux de travail classique permettant de réaliser ces activités.

L'outil gcloud est compatible avec le flux de travail suivant :

  1. Créez un environnement compatible local pour une instance Cloud Datastore, y compris un répertoire, les fichiers requis et l'ID de projet.
  2. Démarrez l'émulateur Cloud Datastore, qui fournit une émulation locale de l'environnement de production Cloud Datastore.
  3. Générez des définitions d'index à partir des requêtes depuis votre application vers l'émulateur.
  4. Importez des définitions d'index créées ou générées manuellement vers votre instance de base de données de production.
  5. 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 flux de travail classique exécuté à l'aide de l'outil gcloud :

  1. Démarrez l'émulateur Datastore.

  2. Définissez les variables d'environnement pour indiquer à votre application qu'elle utilise l'émulateur.

  3. 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.

  4. Téléchargez les index générés avec la commande indexes create, transmettant ainsi le chemin d'accès au fichier index.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 fichier index.yaml.

  5. Supprimez les variables d'environnement pour indiquer à votre application qu'elle utilise l'instance de base de données de production.

  6. Exécutez votre application sur votre instance de base de données de production.

  7. Avec le temps, vous êtes susceptible de ne plus utiliser certains index. Vous pouvez supprimer les index inutilisés de votre instance de base de données de production en les supprimant de votre fichier index.yaml local, puis en appelant la commande indexes 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 l'exemple de chemin d'accès par celui de votre fichier index.yaml.

Étape suivante

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Documentation Cloud Datastore