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

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

La CLI Google Cloud vous permet de tester votre application en local et de 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 CLI gcloud accepte 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 classique permettant d'utiliser la CLI 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.

Étape suivante