ianblenke/couchbase repository overview

⁠Couchbase Docker container

This my a fork of ncolomer/docker-templates⁠ for a maestro-ng deployable version of couchbase

This is a collection of images and scripts to help you run Couchbase community edition (currently 2.2.0 build-837) in Docker containers.

Docker containers are great to provision ephemeral topologies for testing and development purpose. This project was partly inspired by dustin/couchbase⁠.

⁠Prerequisites

You need to override memlock and nofile limits to make Couchbase run correctly. Add the following lines at the end of the /etc/init/docker.conf file:

limit memlock unlimited unlimited
limit nofile 262144

Finally, restart the Docker daemon: /etc/init.d/docker restart.

⁠Single Couchbase node

1. Create the Couchbase container

    docker run -d -name cb ianblenke/couchbase
   

   Copy

   This command starts a Couchbase node as a new cluster and setup a default bucket of 128m (can be changed later in the admin interface). You can also add the options generated by the $(./scripts/ports raz) script to bind Couchbase client ports (8091, 8092, 11210, 11211) to host.

    docker run -d $(./scripts/ports raz) -name cb ianblenke/couchbase
   

   Copy

2. Check the Couchbase instance is up&running

   Using Telnet (Memcached text protocol)

    $ telnet $(./scripts/ipof cb) 11211
    # Check health
    stats
    # Set and get a key
    set test_key 0 0 1
    get test_key
    # Disconnect
    quit
   

   Copy

   Using couchbase-cli

    docker run -rm ianblenke/couchbase couchbase-cli server-info -c $(./scripts/ipof cb) -u Administrator -p couchbase
   

   Copy

   Using HTTP

    curl -u Administrator:couchbase http://$(./scripts/ipof cb):8091/nodes/[email protected]
   

   Copy

   Using admin interface: open the output of echo http://$(./scripts/ipof cb):8091 in your favorite browser. The admin login is Administrator and the password is couchbase.

⁠3-node cluster

Create the containers as following:

docker run -d -name cb1 ianblenke/couchbase
docker run -d -name cb2 ianblenke/couchbase couchbase-start $(./scripts/ipof cb1)
docker run -d -name cb3 ianblenke/couchbase couchbase-start $(./scripts/ipof cb1)

The nodes cb2 and cb3 will automatically join the cluster via cb1. The cluster needs a rebalance to be fully operationnal. To do so, run the following command:

docker run -rm ianblenke/couchbase couchbase-cli rebalance -c $(./scripts/ipof cb1) -u Administrator -p couchbase

Note that you can also trigger a rebalance and show progress from the admin interface.

⁠Two 2-node cluster (XDCR base)

Create the containers as following:

docker run -d $(./scripts/ports raz) -name cb11 ianblenke/couchbase
docker run -d -name cb12 ianblenke/couchbase couchbase-start $(./scripts/ipof cb11)
docker run -d $(./scripts/ports) -name cb21 ianblenke/couchbase
docker run -d -name cb22 ianblenke/couchbase couchbase-start $(./scripts/ipof cb21)

The node cb12 automatically joins the cluster #1 via cb11 and the node cb22 automatically joins the cluster #2 via cb11. The clusters #1 and #2 both need a rebalance to be fully operationnal. To do so, run the following commands:

docker run -rm ianblenke/couchbase couchbase-cli rebalance -c $(./scripts/ipof cb11) -u Administrator -p couchbase
docker run -rm ianblenke/couchbase couchbase-cli rebalance -c $(./scripts/ipof cb21) -u Administrator -p couchbase

• Open the URL http://$CB11_URL:8091 (replace $CB11_URL by the output of ./scripts/ipof cb11) in your favorite browser
• Setup the XDCR as described in the Set Source and Destination Clusters⁠ documentation page. You will have to provide at lease one IP of a node in the cluster #2, the IP returned by ./scripts/ipof cb21 is a good choice.
• Note you can also do all this stuff using command line. See the documentation for the details.

⁠Some docker orchestration magic:

Here is an example maestro-ng configuration for a 3 node couchbase cluster:

name: shared
ships:
  first: { ip: 10.0.0.10, docker_port: 4243 }
  second: { ip: 10.0.0.11, docker_port: 4243 }
  third: { ip: 10.0.0.12, docker_port: 4243 }
services:
  couchbase:
    image: ianblenke/couchbase:2.2.0
    instances:
      couchbase-1:
        ship: first
        ports:  { couchweb: 8091, couchapi: 8092, couchebp: 11210, memcache: 11211, epmd: 4369 }
        lifecycle:
          running: [{type: tcp, port: couchweb},{type: tcp, port: couchapi},{type: tcp, port: couchebp},{type: tcp, port: memcache},{type: tcp, port: epmd}]
        env: {IP: first}
        stop_timeout: 2
        limits: {memory: 5G, cpu: 10}
        command: couchbase-start
      couchbase-2:
        ship: second
        ports:  { couchweb: 8091, couchapi: 8092, couchebp: 11210, memcache: 11211, epmd: 4369 }
        lifecycle:
          running: [{type: tcp, port: couchweb},{type: tcp, port: couchapi},{type: tcp, port: couchebp},{type: tcp, port: memcache},{type: tcp, port: epmd}]
        env: {IP: second}
        stop_timeout: 2
        limits: {memory: 5G, cpu: 10}
        command: couchbase-start first
      couchbase-3:
        ship: third
        ports:  { couchweb: 8091, couchapi: 8092, couchebp: 11210, memcache: 11211, epmd: 4369 }
        lifecycle:
          running: [{type: tcp, port: couchweb},{type: tcp, port: couchapi},{type: tcp, port: couchebp},{type: tcp, port: memcache},{type: tcp, port: epmd}]
        env: {IP: third}
        stop_timeout: 2
        limits: {memory: 5G, cpu: 10}
        command: couchbase-start first

⁠Some routing magic

If you host Docker on a Virtual Machine (a Vagrant managed VM for instance), you can make docker containers reachable from your VM's host by routing request to the docker bridge:

sudo route add -net $DOCKER_BRIDGE $VM_IP

Example:

sudo route add -net 172.17.0.0 192.168.10.10