kefirgames/riak

Riak KV Docker镜像

镜像概述和主要用途

这是一个经过配置改进的Riak KV Docker镜像，支持通过环境变量修改riak.conf中的几乎所有配置。当前提供两个主要版本：2.2.3（生产就绪）和2.9.2（后Basho版本），适用于Riak KV分布式数据库的容器化部署。

核心功能和特性

多版本支持

• Riak KV 2.2.3

  • 标签：stable、2.2.3、stable-basho、2.2.3-basho
  • 基础镜像：ubuntu:16.04
  • 安装源：官方包（-basho标签使用已停用的packagecloud.io包）
  • 状态：生产就绪

• Riak KV 2.9.2

  • 标签：latest、2.9、2.9.2
  • 基础镜像：debian:buster-slim
  • 编译环境：OpenSSL 1.0.2u（2019-12-20）和Basho's Erlang OTP 16
  • 状态：后Basho版本，使用风险自负，https://github.com/basho/riak/blob/develop-2.9/RELEASE-NOTES.md#riak-kv-291-release-notes

核心特性

• 环境变量配置：支持通过环境变量修改riak.conf中的大部分配置项
• 默认存储后端：LevelDB（分层存储，级别4），可通过RIAK_STORAGE_BACKEND变量修改
• 健康检查：内置健康检查机制，通过riak-admin status验证服务状态
• 灵活的高级配置：支持通过挂载advanced.config文件自定义高级配置

使用场景和适用范围

• Riak KV分布式数据库的容器化部署
• 开发、测试环境快速搭建
• 生产环境部署（推荐使用2.2.3版本）
• 需要自定义Riak配置的场景

详细使用方法和配置说明

Docker Compose部署示例

以下是使用docker-compose部署Riak KV的示例配置。示例中列出的环境变量均为默认值，因此可直接运行无需额外配置：

yaml
version: "2"

volumes:
    riak: 

services:
  riak:
    image: kefirgames/riak:2.2.3
    ports:
      - "8087:8087"  # Protobuf端口
      - "8098:8098"  # HTTP端口
    volumes:
      - riak:/etc/riak/schemas
    environment:
        - RIAK_LOG_CONSOLE=file
        - RIAK_LOG_CONSOLE_LEVEL=info
        - RIAK_LOG_SYSLOG=off
        - RIAK_LOG_CRASH=on
        - RIAK_LOG_CRASH_MAXIMUM_MESSAGE_SIZE=64KB
        - RIAK_LOG_CRASH_SIZE=10MB
        - RIAK_LOG_CRASH_ROTATION_KEEP=5
        - RIAK_NODENAME=riak
        - RIAK_RING_SIZE=64
        - RIAK_COOKIE=riak
        - RIAK_ERLANG_ASYNC_THREADS=64
        - RIAK_ERLANG_MAX_PORTS=262144
        - RIAK_DTRACE=off
        - RIAK_DATA_DIR
        - RIAK_LOGS_DIR=/var/log/riak
        - RIAK_LISTENER_HTTP_INTERNAL_PORT=8098
        - RIAK_LISTENER_PROTOBUF_INTERNAL=8087
        - RIAK_ANTI_ENTROPY=active
        - RIAK_STORAGE_BACKEND=leveldb
        - RIAK_OBJECT_FORMAT=1
        - RIAK_OBJECT_SIZE_WARNING_THRESHOLD=5MB
        - RIAK_OBJECT_SIZE_MAXIMUM=50MB
        - RIAK_OBJECT_SIBLINGS_WARNING_THRESHOLD=25
        - RIAK_OBJECT_SIBLINGS_MAXIMUM=100
        - RIAK_BITCASK_DATA_ROOT=${RIAK_DATA_DIR}/bitcask
        - RIAK_BITCASK_IO_MODE=erlang
        - RIAK_CONTROL=off
        - RIAK_CONTROL_AUTH_MODE=off
        - RIAK_LEVELDB_MAXIMUM_MEMORY_PERCENT=70
        - RIAK_LEVELDB_COMPRESSION=on
        - RIAK_LEVELDB_COMPRESSION_ALGORITHM=lz4
        - RIAK_LEVELDB_WRITE_BUFFER_SIZE_MIN=30MB
        - RIAK_LEVELDB_WRITE_BUFFER_SIZE_MAX=60MB
        - RIAK_LEVELDB_BLOCK_SIZE=16KB
        - RIAK_LEVELDB_BLOOMFILTER=on
        - RIAK_LEVELDB_TIERED_LEVEL=4
        - RIAK_LEVELDB_TIERED_PATH_FAST=${RIAK_DATA_DIR}/leveldb/fast
        - RIAK_LEVELDB_TIERED_PATH_SLOW=${RIAK_DATA_DIR}/leveldb/slow
        - RIAK_LEVELDB_DATA_ROOT=./
        - RIAK_SEARCH=off
        - RIAK_SEARCH_SOLR_START_TIMEOUT=30s
        - RIAK_SEARCH_SOLR_PORT=8093
        - RIAK_SEARCH_SOLR_JMX_PORT=8985
        - RIAK_SEARCH_SOLR_JVM_OPTIONS=-d64
    healthcheck:
        test: ["CMD-SHELL", "riak-admin status"]
        interval: 10s
        timeout: 5s
        retries: 10

直接运行Docker命令

无需额外配置即可运行：

bash
docker run -d kefirgames/riak:2.2.3

环境变量配置

默认环境变量

以下环境变量已设置默认值，可根据需要覆盖：

额外默认变量

• HOST: 默认为hostname -i，Riak服务的IPv4地址
• RIAK_HOST: 默认为$HOST，集群中节点的主机名标识
• RIAK_SET_ULIMIT=262144: 设置文件描述符限制的workaround（因docker --ulimit在此不生效）
• RIAK_CHECKCONFIG=True: 启动前运行riak chkconfig，可设为False禁用
• RIAK_AUTOSTART=True: 自动启动Riak服务并等待riak_kv服务就绪，然后执行/etc/riak/poststart.d中的脚本，最后跟踪日志

高级配置 (advanced.config)

默认的advanced.config配置如下：

erlang
[
  {riak_core, [
    {vnode_parallel_start, $RIAK_RING_SIZE},
    {forced_ownership_handoff, $RIAK_RING_SIZE},
    {handoff_concurrency, $RIAK_RING_SIZE}
  ]},

 {riak_repl,
   [
    {data_root, "/var/lib/riak/riak_repl/"},
    {max_fssource_cluster, 5},
    {max_fssource_node, 1},
    {max_fssink_node, 1},
    {fullsync_on_connect, true},
    {fullsync_interval, 30},
    {rtq_max_bytes, 104857600},
    {proxy_get, disabled},
    {rt_heartbeat_interval, 15},
    {rt_heartbeat_timeout, 15},
    {fullsync_use_background_manager, true}
   ]},

  {lager,
   [
      {extra_sinks,
           [
            {object_lager_event,
             [{handlers,
               [{lager_file_backend,
                 [{file, "/var/log/riak/object.log"},
                  {level, info},
                  {formatter_config, [date, " ", time," [",severity,"] ",message, "\n"]}
                 ]
                }]
              },
              {async_threshold, 500},
              {async_threshold_window, 50}]
            }
            ]
      }
    ]
}].

可通过挂载自定义文件覆盖默认配置：

bash
docker run -d -v /path/to/advanced.config:/etc/riak/advanced.config kefirgames/riak:2.2.3