tree: 6202aab5b51c8b436507985fec6eb518c71e1a30 [path history] [tgz]
  1. compose/
  2. docker-compose.yaml
  3. README.md
deploy/docker-compose/README.md

Apache BookKeeper docker-compose

Requirements

  • Docker >= 16.10
  • Docker Compose >= 1.6.0

Quick start

$ git clone https://github.com/apache/bookkeeper.git
$ cd bookkeeper/deploy/docker-compose
$ docker-compose pull # Get the latest Docker images
$ docker-compose up -d
$ cd ../../
$ bin/bkctl bookies list
$ bin/bkctl ledger simpletest

Access Apache BookKeeper cluster

Ledger Service

You can use zk://localhost:2181/ledgers as metadataServiceUri to access ledger storage service.

$ bin/bkctl -u 'zk://localhost:2181/ledgers' ledger simpletest 

DistributedLog

You can use distributedlog://localhost:2181/distributedlog as dlog uri to access ledger storage service using distributedlog API.

$ bin/dlog tool create -u 'distributedlog://localhost:2181/distributedlog' --prefix test-stream -e 0-99

Customize Apache BookKeeper Cluster

Install Helm

Helm is used as a template render engine

curl https://raw.githubusercontent.com/kubernetes/helm/master/scripts/get | bash

Or if you use Mac, you can use homebrew to install Helm by brew install kubernetes-helm

Bring up Apache BookKeeper cluster

$ git clone https://github.com/apache/bookkeeper.git
$ cd bookkeeper/deploy/docker-compose
$ vi compose/values.yaml # custom cluster size, docker image, port mapping etc
$ helm template compose > generated-docker-compose.yaml
$ docker-compose -f generated-docker-compose.yaml pull # Get the latest Docker images
$ docker-compose -f generated-docker-compose.yaml up -d