Testar usando o emulador

A Google Cloud CLI fornece um emulador local na memória para o Bigtable, que pode ser usado para testar o aplicativo. Como o o emulador armazena dados apenas na memória. Ele não armazenará dados nas execuções. O objetivo é ajudar você a usar o Bigtable para desenvolvimento e testes locais, não para implantações de produção.

Você pode usar o emulador com todas as bibliotecas de cliente do Cloud Bigtable.

O emulador não oferece APIs administrativas para criar ou gerenciar instâncias e clusters. Após a inicialização do emulador, você poderá se conectar a ele usando qualquer nome de instância e projeto para criar tabelas e ler ou gravar dados. O emulador não oferece suporte a uma conexão segura.

Instalar e executar o emulador

As duas maneiras mais comuns de executar o emulador são usando a CLI gcloud e Docker. Escolha a maneira apropriada para o fluxo de trabalho de desenvolvimento e teste do aplicativo.

Configurar a autenticação

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

CLI da gcloud

  1. Atualize a instalação da CLI da gcloud para receber os recursos mais recentes:

    gcloud components update beta
    
  2. Execute o seguinte comando para iniciar o emulador:

    gcloud beta emulators bigtable start
    

    Se o emulador não estiver instalado, você será solicitado a fazer download e instalar o binário para o emulador.

    O emulador imprime o host e o número da porta em que está sendo executado.

    Por padrão, o emulador escolhe localhost:8086. Para vincular o emulador a uma host e porta específicos, use a sinalização --host-port opcional, substituindo HOST e PORT:

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

    Veja um exemplo abaixo.

    gcloud beta emulators bigtable start --host-port=localhost:8086
    
  3. Digite Control-C para interromper o emulador.

Docker

  1. Verifique se o Docker está instalado no seu sistema e disponível no caminho do sistema.

  2. Inicie o emulador.

    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
    

    Esse comando executa o emulador e mapeia as portas no contêiner para as mesmas portas no host local.

Você também pode usar o emulador como parte do arquivo de configuração atual do Docker Compose (.yaml). Para mais informações sobre o Docker Compose, consulte Visão geral do Docker Compose.

Como usar as bibliotecas de cliente com o emulador

Defina a variável de ambiente BIGTABLE_EMULATOR_HOST para usar as bibliotecas de cliente com o emulador:

Linux / macOS

  export BIGTABLE_EMULATOR_HOST=localhost:8086

Windows

  set BIGTABLE_EMULATOR_HOST=localhost:8086

Quando o aplicativo é iniciado, a biblioteca de cliente verifica automaticamente se há BIGTABLE_EMULATOR_HOST e se conecta ao emulador se ele estiver em execução.

Depois que BIGTABLE_EMULATOR_HOST for definido, você poderá testar o emulador seguindo as amostras do hello world.

Para interromper o emulador, digite Control-C e cancele a configuração de BIGTABLE_EMULATOR_HOST com o seguinte comando:

    unset BIGTABLE_EMULATOR_HOST

Wrapper Java para o emulador

O wrapper Java agrupa o emulador integrado do Bigtable e fornece uma interface Java para criar testes.

Para mais informações sobre como usar o wrapper Java, consulte o repositório do GitHub.

A documentação a seguir fornece mais informações sobre os pacotes Java do emulador:

Filtros

O emulador é compatível com todos os filtros, exceto o Sink.

Os problemas relacionados ao emulador do Bigtable são rastreados no repositório google-cloud-go do GitHub, em que é possível enviar relatórios de bugs e solicitações de recursos ou comentar problemas atuais.