hectcastro/riak

docker-riak ![Build Status]([***]

这是一个用于搭建本地https://github.com/basho/riak%E9%9B%86%E7%BE%A4%E7%9A%84Docker%E9%A1%B9%E7%9B%AE%E3%80%82

前提条件

安装Docker

按照https://www.docker.io/gettingstarted/#h_installation%E5%AE%89%E8%A3%85Docker%E3%80%82

许多Docker环境会设置DOCKER_HOST环境变量帮助客户端连接Docker主机，部分环境默认使用Unix域套接字。若通过TCP连接Docker主机，请确保DOCKER_HOST变量正确设置：

bash
$ export DOCKER_HOST="tcp://127.0.0.1:2375"

注意：若使用https://github.com/boot2docker/boot2docker%EF%BC%8C%E9%9C%80%E8%BD%AC%E5%8F%91%E8%99%9A%E6%8B%9F%E6%9C%BA%E7%AB%AF%E5%8F%A3%E8%8C%83%E5%9B%B4%EF%BC%8849000-49900%EF%BC%89%E3%80%82%E8%8B%A5%E8%AE%BE%E7%BD%AE%60DOCKER_RIAK_BASE_HTTP_PORT%60%EF%BC%8C%E5%88%99%E9%9C%80%E8%BD%AC%E5%8F%91%E8%AF%A5%E7%AB%AF%E5%8F%A3%E8%8C%83%E5%9B%B4%EF%BC%9A

bash
$ for i in {49000..49900}; do
 VBoxManage modifyvm "boot2docker-vm" --natpf1 "tcp-port$i,tcp,,$i,,$i";
 VBoxManage modifyvm "boot2docker-vm" --natpf1 "udp-port$i,udp,,$i,,$i";
done

sysctl配置

为优化运行Riak容器的Docker主机，建议应用以下sysctl设置：

vm.swappiness = 0
net.ipv4.tcp_max_syn_backlog = 40000
net.core.somaxconn = 40000
net.ipv4.tcp_sack = 1
net.ipv4.tcp_window_scaling = 1
net.ipv4.tcp_fin_timeout = 15
net.ipv4.tcp_keepalive_intvl = 30
net.ipv4.tcp_tw_reuse = 1
net.ipv4.tcp_moderate_rcvbuf = 1

运行步骤

克隆仓库并构建Riak镜像

bash
$ git clone https://github.com/hectcastro/docker-riak.git
$ cd docker-riak
$ make build

环境变量说明

• DOCKER_RIAK_CLUSTER_SIZE：集群节点数量（默认：5）
• DOCKER_RIAK_AUTOMATIC_CLUSTERING：自动集群化开关（默认：false）
• DOCKER_RIAK_DEBUG：集群管理脚本调试开关（默认：false）
• DOCKER_RIAK_BASE_HTTP_PORT：固定端口分配基准，需手动转发DOCKER_RIAK_BASE_HTTP_PORT + $index到8098（Riak HTTP端口），转发DOCKER_RIAK_BASE_HTTP_PORT + $index + DOCKER_RIAK_PROTO_BUF_PORT_OFFSET到8087（Riak Protocol Buffers端口）
• DOCKER_RIAK_PROTO_BUF_PORT_OFFSET：端口偏移量（默认：100）
• DOCKER_RIAK_BACKEND：Riak存储后端（默认：bitcask）
• DOCKER_RIAK_STRONG_CONSISTENCY：强一致性子系统开关（值：on/off，默认：off）

启动集群

bash
$ DOCKER_RIAK_AUTOMATIC_CLUSTERING=1 DOCKER_RIAK_CLUSTER_SIZE=5 DOCKER_RIAK_BACKEND=leveldb make start-cluster
./bin/start-cluster.sh

Bringing up cluster nodes:

Starting riak01..... Completed
Starting riak02..... Completed
Starting riak03..... Completed
Starting riak04..... Completed
Starting riak05..... Completed

Please wait approximately 30 seconds for the cluster to stabilize.

测试方法

HTTP接口

Riak HTTP接口提供/stats端点输出统计信息。使用make test-cluster目标可访问随机容器的/stats端点并打印结果，其中ring_members和ring_ownership字段可验证集群成员关系：

bash
$ make test-cluster | egrep -A6 "ring_members"
    "ring_members": [
        "riak@172.17.0.2",
        "riak@172.17.0.3",
        "riak@172.17.0.4",
        "riak@172.17.0.5",
        "riak@172.17.0.6"
    ],

SSH登录

https://github.com/phusion/baseimage-docker%E9%95%9C%E5%83%8F%E6%94%AF%E6%8C%81%E9%80%9A%E8%BF%87%E4%B8%8D%E5%AE%89%E5%85%A8%E5%AF%86%E9%92%A5SSH%E7%99%BB%E5%BD%95%E5%AE%B9%E5%99%A8%EF%BC%88%E9%BB%98%E8%AE%A4%E5%90%AF%E7%94%A8%EF%BC%89%E3%80%82%E6%AD%A5%E9%AA%A4%E5%A6%82%E4%B8%8B%EF%BC%9A

1. 用docker inspect获取容器IP：

bash
$ docker inspect $CONTAINER_ID | grep IPAddress
        "IPAddress": "172.17.0.2",

2. 下载密钥并登录：

bash
$ curl -o insecure_key -fSL https://github.com/phusion/baseimage-docker/raw/master/image/services/sshd/keys/insecure_key
$ chmod 600 insecure_key
$ ssh -i insecure_key root@172.17.0.2

注意：若使用boot2docker，需在boot2docker虚拟机内执行SSH命令。

停止集群

bash
$ make stop-cluster
./bin/stop-cluster.sh
Stopped all of the running containers.

销毁集群

bash
$ make remove-cluster
./bin/remove-cluster.sh
Stopped the cluster and cleared all of the running containers.