Usa la herramienta gcloud para probar aplicaciones y administrar índices

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

La CLI de gcloud admite el siguiente flujo de trabajo:

  1. Crea asistencia local para una instancia de Datastore, lo que incluye 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 de forma manual a tu instancia de base de datos de producción.
  5. Borra los índices no utilizados de tu instancia de base de datos de producción.

Flujo de trabajo de desarrollo que utiliza la herramienta de línea de comandos

A continuación, se detalla el flujo de trabajo típico que usa gcloud CLI:

  1. Inicia el emulador de Datastore.

  2. Establece variables del entorno para que tu aplicación sepa que está utilizando el emulador.

  3. Inicia tu aplicación para probarla en el emulador. Debes ejecutar las consultas que usa tu aplicación en el emulador a fin de generar índices para la instancia de base de datos de producción.

  4. Sube los índices generados con el comando indexes create y pasa la ruta de tu archivo index.yaml local, como se muestra en el siguiente ejemplo:

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

    La ruta del ejemplo supone que no configuraste un directorio específico para la opción data-dir. Si configuraste un directorio específico, modifica la ruta para usar la ruta de acceso al archivo index.yaml.

  5. Quita las variables de entorno, de tal forma que tu aplicación sepa que está usando la instancia de base de datos de producción.

  6. Ejecuta la 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. Puedes borrar los índices que no uses de tu instancia de base de datos de producción. Para ello, debes quitarlos del archivo index.yaml local y, luego, invocar el comando indexes cleanup:

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

    Si configuraste un directorio específico para la opción data-dir, modifica la ruta del ejemplo a fin de usar la ruta de acceso a tu archivo index.yaml.

¿Qué sigue?