basho/riak-kv

Riak KV

该镜像基于支持asciibuild（文字化构建方式）的仓库构建：https://github.com/basho-labs/riak-docker

!Travis CI Build

“Riak KV是一款分布式NoSQL键值数据库，具备高级本地及多集群复制能力，即使在硬件故障或网络分区情况下也能保证读写操作的可用性。”——Basho

启动Riak KV集群

使用docker-compose启动简单集群：创建riak工作目录，新建docker-compose.yml文件如下（coordinator为集群初始节点，暴露可预测端口）：

yaml
version: "2"
services:
  coordinator:
    image: basho/riak-kv
    ports:
      - "8087:8087"
      - "8098:8098"
    environment:
      - CLUSTER_NAME=riakkv
    labels:
      - "com.basho.riak.cluster.name=riakkv"
    volumes:
      - schemas:/etc/riak/schemas
  member:
    image: basho/riak-kv
    ports:
      - "8087"
      - "8098"
    labels:
      - "com.basho.riak.cluster.name=riakkv"
    links:
      - coordinator
    depends_on:
      - coordinator
    environment:
      - CLUSTER_NAME=riakkv
      - COORDINATOR_NODE=coordinator

volumes:
  schemas:
    external: false

启动单节点集群：

bash
$ docker-compose up -d coordinator

访问localhost:8098/admin/打开Riak Explorer，可通过UI创建数据类型或使用http://basho-labs.github.io/riak_explorer/docs/api.html%E4%BA%A4%E4%BA%92%E3%80%82

扩展集群

通过docker-compose扩展节点数量：

bash
$ docker-compose scale member=4

集群将扩展为5节点（1 coordinator +4 member），刷新Riak Explorer的OPS页面可见新节点（Docker内部IP：172.18.0.X）。

数据持久化

若需持久化数据，挂载卷到容器/var/lib/riak路径，参考官方docker-compose文档。

主机端口发现

获取连接节点的HOST:PORT值：

bash
$ export RIAK_HOSTS=$(echo $(docker inspect $(docker ps -q -f label=com.basho.riak.cluster.name=$CLUSTER_NAME) | jq -r '.[] | "localhost:" + .NetworkSettings.Ports."8087/tcp"[0].HostPort') | tr ' ' ',')

修改集群名称标签时需同步更新命令中的过滤器。

数据类型引导

镜像支持自动加载.dt后缀的schema文件（路径/etc/riak/schemas/），文件名（不含后缀）为桶名。创建schemas卷并复制本地文件：

bash
$ docker run --rm -it -v riak_schemas:/etc/riak/schemas -v $(pwd)/schemas:/tmp/schemas alpine cp /tmp/schemas/* /etc/riak/schemas/

启动集群时会自动执行riak-admin bucket type create及激活命令。