This repository contains a set of scripts and configuration files to run a Cassandra cluster from Docker containers. The current version of this repository is configured to create a Cassandra 1.2 or 2.0 image and cluster.
Example:
Cassandra nodes are created with their own IP address and configured hostname:
$ ./start-cluster.sh 2.0.3 3
Starting node 1
Starting node 2
Starting node 3
$ ./client.sh 2.0.3 nodetool -h cass1 status
Datacenter: datacenter1
=======================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
-- Address Load Tokens Owns Host ID Rack
UN 192.168.100.3 40.84 KB 256 34.9% 9d4a223f-e80e-4b50-b379-0705b1c8971d rack1
UN 192.168.100.1 38.93 KB 256 33.7% 5128dcb0-14d0-4d17-9b53-acc8f9a0844b rack1
UN 192.168.100.2 30.92 KB 256 31.4% 8e6faaba-601f-4812-a33b-05ceaecf1159 rack1
Note that the nodes might take about 30 seconds to show up as they join the Cassandra ring.
The shell scripts all assume that you have sudo privilege.
$ git clone https://github.com/nicolasff/docker-cassandra.git
$ cd docker-cassandra
Make sure that the bundled script pipework is in your path. You can install it with:
$ sudo cp install/bin/pipework /usr/bin/
The latest version is on GitHub at https://github.com/jpetazzo/pipework.
To create a Cassandra 2.0.3 image and tag it, run:
$ make image VERSION=2.0.3
You should then see it appear in your list of Docker images:
$ sudo docker images
REPOSITORY TAG ID CREATED SIZE
cassandra 2.0.3 b9ba84a33bb5 About a minute ago 12.29 kB (virtual 404.7 MB)
$ ./list-images.sh
2.0.3
Run ./start-cluster.sh 2.0.3 3 to create a cluster of 3 nodes running Cassandra 2.0.3. They are given an IP address and name each, from cass1 (192.168.100.1) to cass3 (192.168.100.3).
Run sudo docker ps to list your Cassandra nodes:
$ sudo docker ps
ID IMAGE COMMAND CREATED STATUS PORTS
99d67692f535 cassandra:2.0.3 /usr/bin/start-cassa 10 minutes ago Up 10 minutes 49332->9160
fe7e2b13cb9e cassandra:2.0.3 /usr/bin/start-cassa 10 minutes ago Up 10 minutes 49331->9160
f21da380b00c cassandra:2.0.3 /usr/bin/start-cassa 10 minutes ago Up 10 minutes 49330->9160
Cassandra nodes expose port 9160 for Thrift. Use sudo docker port <container-id> 9160 or sudo docker ps to find the local port it is mapped to.
client.sh creates a docker container with access to the Cassandra cluster network (192.168.100.0/24). The first client is given the name cass254
with IP 192.168.100.254, the next one cass253, etc. Names are reused when client containers are stopped.
client.sh runs any command that is passed to it, e.g. nodetool, cassandra-cli, cqlsh... You can also open a shell with ./client.sh 2.0.3 bash.
$ ./stop-cluster.sh 2.0.3
Killing and removing containers 99d67692f535 fe7e2b13cb9e f21da380b00c
$ sudo docker ps
ID IMAGE COMMAND CREATED STATUS PORTS
This set of scripts and configuration files is released under the Apache 2.0 License.
pipework is Copyright 2013 Jérôme Petazzoni and distributed under the Apache 2.0 license.
Contributions and suggestions welcome on GitHub or on Twitter.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent