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

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

gcloud CLI supporta il seguente flusso di lavoro:

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

Il flusso di lavoro di sviluppo mediante 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 utilizza l'emulatore.

  3. Avvia l'applicazione e testala nell'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 al 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 tu non abbia impostato una directory specifica per l'opzione data-dir. Se hai impostato una directory specifica, modifica il percorso in modo da utilizzare quello 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 corso del tempo, alcuni indici potrebbero non essere più utilizzati. Puoi eliminare gli indici non utilizzati dall'istanza del database di produzione rimuovendoli dal file index.yaml locale e 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