bigtruedata/gcloud-bigtable-emulator repository overview

⁠Google Cloud SDK Bigtable Emulator Image⁠

Cloud Bigtable⁠ is a high performance NoSQL database service for large analytical and operational workloads.

This image provides a dockerized version of the Google Cloud Bigtable Emulator. It is intended to be used as a service on development environments (it SHOULD NOT be used in production environments). You can check Cloud Bigtable documentation on Google Cloud Platform documentation website⁠.

⁠Usage

The following shell statement shows the most simple execution of the provided image. It will execute an instance of the Bigtable Emulator that will listen on port 8086.

docker run --rm --tty --interactive --publish 8086:8086 bigtruedata/gcloud-bigtable-emulator

The image is much more useful when it is used in a CD/CI automated environment. The following example shows how to configure the Bigtable Emulator to be used as a service in a Wercker⁠ development pipeline.

box: python:3.5

dev:
  services:
    - name: bigtable
      id: bigtruedata/gcloud-bigtable-emulator
      cmd: start --host-port 0.0.0.0:8086

  steps:
    - script:
      name: Define Bigtable environment variables
      code: |
        ADDR=$BIGTABLE_PORT_8086_TCP_ADDR
        PORT=$BIGTABLE_PORT_8086_TCP_PORT
        export BIGTABLE_EMULATOR_HOST=$ADDR:$PORT

    - internal/shell:
      cmd: bash

⁠Configuration

The default values for the host ad the port where the Bigtable emulator image will listen on when executed can be configured by setting the corresponding --host-port command-line option when running the image. By default, the values for the host is 127.0.0.1 and the port is 8086.

The following example shows how to start the Bigtable emulator to listen on 192.168.1.3:12345.

docker run --rm --tty --interactive bigtruedata/gcloud-bigtable-emulator start --host-port=192.168.1.3:12345

NOTE: Wercker's documentation can be checked online on Wercker Documentation Website⁠