Usar la herramienta gcloud para probar aplicaciones y gestionar índices

Puedes usar la CLI de Google Cloud para probar tu aplicación de forma local y para gestionar los índices de tu instancia de producción de Firestore en el modo de Datastore. En esta página se describe el flujo de trabajo habitual para estas actividades.

La CLI de gcloud admite el siguiente flujo de trabajo:

  1. Crea asistencia local para una instancia de Datastore, incluidos el directorio, los archivos necesarios y el ID del proyecto.
  2. Inicia el emulador de Datastore, que proporciona una emulación local del entorno de producción de Datastore.
  3. Genera definiciones de índice a partir de las consultas de tu aplicación al emulador.
  4. Sube las definiciones de índice creadas o generadas manualmente a tu instancia de base de datos de producción.
  5. Elimina los índices que no utilices de tu instancia de base de datos de producción.

El flujo de trabajo de desarrollo con la herramienta de línea de comandos

Este es el flujo de trabajo habitual con gcloud CLI:

  1. Inicia el emulador de Datastore.

  2. Define variables de entorno para que tu aplicación sepa que está usando el emulador.

  3. Inicia tu aplicación y pruébala con el emulador. Debes ejecutar las consultas que usa tu aplicación en el emulador para generar índices para tu instancia de base de datos de producción.

  4. Sube los índices generados con el comando indexes create. Para ello, indica la ruta de tu archivo index.yaml local, como en el siguiente ejemplo:

    gcloud datastore indexes create ~/.config/gcloud/emulators/datastore/WEB-INF/index.yaml

    En la ruta de ejemplo se presupone que no has definido un directorio específico para la opción data-dir. Si ha definido un directorio específico, modifique la ruta para usar la ruta a su archivo index.yaml.

  5. Elimina las variables de entorno para que tu aplicación sepa que está usando la instancia de base de datos de producción.

  6. Ejecuta tu aplicación en tu instancia de base de datos de producción.

  7. Con el tiempo, es posible que dejes de usar algunos de los índices. Puede eliminar los índices que no utilice de su instancia de base de datos de producción quitándolos del archivo index.yaml local e invocando el comando indexes cleanup:

    gcloud datastore indexes cleanup ~/.config/gcloud/emulators/datastore/WEB-INF/index.yaml

    Si ha definido un directorio específico para la opción data-dir, modifique la ruta del ejemplo para usar la ruta de su archivo index.yaml.

Siguientes pasos