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

Vous pouvez tester votre application localement et gérer les index de votre instance de production Firestore en mode Datastore à l'aide de l'outil de ligne de commande gcloud. Cette page décrit le workflow type permettant de réaliser ces activités.

L'outil gcloud est compatible avec le workflow suivant :

  1. 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.
  2. Lancez l'émulateur Datastore, qui fournit une émulation locale de l'environnement Datastore de production.
  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 workflow type 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. Importez les index générés à l'aide de la commande indexes create pour transmettre 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 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 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 le chemin d'accès de l'exemple par celui de votre fichier index.yaml.

Étapes suivantes