docker-phoenix-mini

A mini Apache Phoenix cluster for local development and testing based on the official HBaseTestingUtility.

docker pull salesforce/phoenix-mini

The key configurations to make the embedded server working in docker are the following:

Build

Generate the executable jar docker-phoenix-mini.jar and the docker image.

mvn package

Docker

All sql scripts copied under the directory /opt/hbase/schema will be executed. The container will report the status as healthy as soon as the server is up and running and all sql have been executed.

An example of how to run the container via docker-compose:

hbase:
    image: docker-phoenix-mini
    container_name: docker-phoenix-mini
    ports:
      - 2181:2181
      - 16000:16000
      - 16010:16010
      - 16020:16020
      - 16030:16030
      - 8080:8080
      - 8085:8085
    volumes:
      - ./hbase/schema:/opt/hbase/schema

Health check

docker-phoenix-mini has a built-in health check endpoint http://localhost:18080/health that reports 200 when the cluster is UP and running and the schema migrations executed.

The container ships with a built-in HEALTHCHECK that reports the health status back to docker:

docker inspect -f '{{.State.Health}}' docker-phoenix-mini

or

docker inspect --format='{{json .State.Health}}' docker-phoenix-mini | jq -r .Status

When the container is healthy it should output something like :

{healthy 0 [0xc0002980a0 0xc0002980f0 0xc000298140 0xc000298190 0xc0002981e0]}

Ports