Utilizzo dello strumento gcloud per testare le applicazioni e gestire gli indici

Puoi utilizzare Google Cloud CLI per testare l'applicazione in locale e per gestire gli indici per l'istanza Firestore in produzione in modalità Datastore. Questa pagina descrive il flusso di lavoro tipico per queste attività.

Gcloud CLI supporta il seguente flusso di lavoro:

  1. Crea il supporto locale per un'istanza Datastore, inclusa la directory, i file richiesti e l'ID progetto.
  2. Avvia l'emulatore Datastore, che fornisce l'emulazione locale dell'ambiente Datastore di produzione.
  3. Genera le definizioni degli indici dalle query dell'applicazione all'emulatore.
  4. Carica le definizioni degli indici create o generate manualmente nell'istanza di database di produzione.
  5. Elimina gli indici inutilizzati dall'istanza di database di produzione.

Il flusso di lavoro di sviluppo utilizzando lo strumento a riga di comando

Di seguito è riportato il flusso di lavoro tipico che utilizza gcloud CLI:

  1. Avvia l'emulatore Datastore.

  2. Imposta le variabili di ambiente in modo che l'applicazione sappia che sta utilizzando l'emulatore.

  3. Avvia l'applicazione e testala sull'emulatore. Devi eseguire le query utilizzate dall'applicazione sull'emulatore per generare gli indici per l'istanza del database di produzione.

  4. Carica gli indici generati con il comando indexes create, passando il percorso del file index.yaml locale, come nell'esempio seguente:

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

    Il percorso di esempio presuppone che non sia stata impostata una directory specifica per l'opzione data-dir. Se hai impostato una directory specifica, modifica il percorso in modo da utilizzare il percorso del file index.yaml.

  5. Rimuovi le variabili di ambiente in modo che l'applicazione sappia che sta utilizzando l'istanza del database di produzione.

  6. Esegui l'applicazione sull'istanza del database di produzione.

  7. Nel tempo, potresti non utilizzare più alcuni degli indici. Puoi eliminare gli indici inutilizzati dall'istanza del database di produzione rimuovendoli dal file index.yaml locale e poi richiamando il comando indexes cleanup:

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

    Se hai impostato una directory specifica per l'opzione data-dir, modifica il percorso nell'esempio in modo da utilizzare il percorso del file index.yaml.

Passaggi successivi