Testare utilizzando l'emulatore

Il Google Cloud CLI fornisce un emulatore in memoria locale per Bigtable, che puoi utilizzare per testare la tua applicazione. Poiché l'emulatore archivia i dati solo in memoria, non li conserverà tra le esecuzioni. È progettato per aiutarti a utilizzare Bigtable per lo sviluppo e i test locali, non per i deployment di produzione.

Puoi utilizzare l'emulatore con tutte le librerie client di Cloud Bigtable.

L'emulatore non fornisce API amministrative per creare o gestire istanze e cluster. Dopo l'avvio dell'emulatore, puoi connetterti utilizzando qualsiasi nome di progetto e istanza per creare tabelle e leggere o scrivere dati. L'emulatore non supporta una connessione sicura.

Installare ed eseguire l'emulatore

I due modi più comuni per eseguire l'emulatore sono l'utilizzo di gcloud CLI e Docker. Scegli il modo più adatto al flusso di lavoro di sviluppo e test dell'applicazione.

Configurare l'autenticazione

Nella Google Cloud console, attiva Cloud Shell.

Attiva Cloud Shell

Nella parte inferiore della Google Cloud console, viene avviata una sessione di Cloud Shell e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già inclusa e installata e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.

gcloud CLI

  1. Aggiorna l'installazione di gcloud CLI per ottenere le funzionalità più recenti:

    gcloud components update beta

  2. Esegui il seguente comando per avviare l'emulatore:

    gcloud beta emulators bigtable start

    Se l'emulatore non è già installato, ti verrà chiesto di scaricare e installare il file binario per l'emulatore.

    L'emulatore stampa l'host e il numero di porta su cui è in esecuzione.

    Per impostazione predefinita, l'emulatore sceglie localhost:8086. Per associare l'emulatore a un host e una porta specifici, utilizza il flag facoltativo --host-port, sostituendo HOST e PORT:

    gcloud beta emulators bigtable start --host-port=HOST:PORT

    Di seguito è riportato un esempio:

    gcloud beta emulators bigtable start --host-port=localhost:8086

  3. Digita Control-C per arrestare l'emulatore.

Docker

  1. Assicurati che Docker sia installato sul tuo sistema e disponibile nel percorso di sistema.

  2. Avvia l'emulatore:

    docker run -p 127.0.0.1:8086:8086 --rm -ti google/cloud-sdk gcloud beta emulators bigtable start --host-port=0.0.0.0:8086

    Questo comando esegue l'emulatore e mappa le porte nel container alle stesse porte dell'host locale.

Puoi anche utilizzare l'emulatore come parte del file di configurazione Docker Compose (.yaml) esistente. Per saperne di più su Docker Compose, consulta la panoramica di Docker Compose.

Utilizzare le librerie client con l'emulatore

Imposta la variabile di ambiente BIGTABLE_EMULATOR_HOST per utilizzare le librerie client con l'emulatore:

Linux / macOS

  export BIGTABLE_EMULATOR_HOST=localhost:8086

Windows

  set BIGTABLE_EMULATOR_HOST=localhost:8086

Quando l'applicazione viene avviata, la libreria client controlla automaticamente BIGTABLE_EMULATOR_HOST e si connette all'emulatore se è in esecuzione.

Una volta impostato BIGTABLE_EMULATOR_HOST, puoi testare l'emulatore seguendo gli esempi di Hello World.

Per arrestare l'emulatore, digita Control-C, quindi annulla l'impostazione di BIGTABLE_EMULATOR_HOST con il seguente comando:

    unset BIGTABLE_EMULATOR_HOST

Wrapper Java per l'emulatore

Il wrapper Java raggruppa l'emulatore Bigtable integrato e fornisce un'interfaccia Java per scrivere test.

Per saperne di più sull'utilizzo del wrapper Java, consulta il repository GitHub.

La seguente documentazione fornisce ulteriori informazioni sui pacchetti Java dell'emulatore:

Filtri

L'emulatore supporta tutti i filtri, ad eccezione del Sink filtro di limitazione.

I problemi relativi all'emulatore Bigtable vengono monitorati nel repository GitHub google-cloud-go, dove puoi inviare segnalazioni di bug e richieste di funzionalità o commentare i problemi esistenti.