Cómo usar la herramienta gcloud para probar aplicaciones y administrar índices

Puedes usar la herramienta de línea de comandos de gcloud a fin de probar tu aplicación de forma local y administrar índices para tu instancia de producción de Cloud Firestore en modo Datastore. En esta página, se describe el flujo de trabajo típico para estas actividades.

La herramienta gcloud admite el siguiente flujo de trabajo:

  1. Crea asistencia local para una instancia de Cloud Datastore, incluidos el directorio, los archivos necesarios y el ID del proyecto.
  2. Inicia el emulador de Cloud Datastore, el cual proporciona emulación local del entorno de producción de Cloud 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 utiliza la herramienta gcloud:

  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 utiliza 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 local index.yaml, 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, modifícala para utilizar la ruta de tu 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 utilizar algunos de los índices. Puedes borrar los que no utilices 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 que se muestra en el ejemplo a fin de usar la ruta a tu archivo index.yaml.

Pasos siguientes

¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

Documentación de Cloud Datastore