library/aerospike

Aerospike数据库Docker镜像

镜像概述

Aerospike是一个分布式NoSQL数据库，专为高性能Web规模应用设计。它支持键值和文档数据模型，提供多种数据类型（列表、映射、HyperLogLog、GeoJSON和Blob）。其专利混合内存架构在大规模部署时提供可预测的高性能和高节点数据密度。

!https://raw.githubusercontent.com/docker-library/docs/42ae663b4b922326e5c55c7c513c8d04a11f9aaf/aerospike/logo.png

快速参考

• 维护者：
  https://github.com/aerospike/aerospike-server.docker

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux 或 Stack Overflow

• 支持的标签及对应Dockerfile链接：

  • https://github.com/aerospike/aerospike-server.docker/blob/aca2fba6072cf602c24fb500e9f0d71ff404b135/enterprise/ubuntu24.04/Dockerfile
  • https://github.com/aerospike/aerospike-server.docker/blob/aca2fba6072cf602c24fb500e9f0d71ff404b135/community/ubuntu24.04/Dockerfile

• 问题反馈：
  Aerospike论坛 或 https://github.com/aerospike/aerospike-server.docker/issues

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/aerospike/%E3%80%81https://hub.docker.com/r/arm64v8/aerospike/

核心功能与特性

• 高性能架构：专利混合内存架构，实现可预测的高性能和高数据密度
• 多数据模型：支持键值和文档数据模型，提供列表、映射等多种数据类型
• 灵活部署：提供企业版(EE)和社区版(CE)，支持容器化部署
• 可扩展性：支持分布式集群部署，轻松扩展以应对Web规模应用需求
• 配置灵活：支持通过环境变量注入配置参数或使用自定义配置文件
• 数据持久化：支持目录挂载、块存储等多种持久化方式

适用场景

• 高性能Web应用数据存储
• 实时分析和高频读写场景
• 需要可预测性能的分布式系统
• 开发和测试环境的快速部署
• 容器化架构中的数据层服务

快速开始

版本说明

• EE版本：企业版，需要功能密钥文件启动，支持高级企业特性
• CE版本：社区版，无需功能密钥文件，提供与EE相同的开发者API

运行Aerospike CE节点

console
docker run -d --name aerospike -p 3000-3002:3000-3002 aerospike:ce-[version]

运行Aerospike EE节点

使用映射目录中的功能密钥文件

console
docker run -d -v DIR:/opt/aerospike/etc/ -e "FEATURE_KEY_FILE=/opt/aerospike/etc/features.conf" --name aerospike -p 3000-3002:3000-3002 aerospike:ee-[version]

说明：将DIR替换为包含功能密钥文件的本地目录，确保Docker有权限访问该目录进行绑定挂载。

使用环境变量中的功能密钥文件

console
FEATKEY=$(base64 ~/Desktop/evaluation-features.conf)
docker run -d -e "FEATURES=$FEATKEY" -e "FEATURE_KEY_FILE=env-b64:FEATURES" --name aerospike -p 3000-3002:3000-3002 aerospike:ee-[version]

高级配置

通过环境变量注入配置参数

可使用-e标志注入环境变量来配置模板参数，例如设置命名空间名称为demo：

console
docker run -d --name aerospike -e "NAMESPACE=demo" -p 3000-3002:3000-3002 -v /my/dir:/opt/aerospike/etc/ -e "FEATURE_KEY_FILE=/opt/aerospike/etc/features.conf" aerospike:ee-[version]

常用配置参数

使用自定义配置文件

通过挂载本地目录并指定配置文件路径来使用自定义配置：

console
docker run -d -v /opt/aerospike/etc/:/opt/aerospike/etc/ --name aerospike -p 3000-3002:3000-3002 aerospike:ee-[version] --config-file /opt/aerospike/etc/aerospike.conf

数据持久化配置

持久化数据目录

挂载主机目录到容器的/opt/aerospike/data以持久化数据：

console
docker run -d -v /opt/aerospike/data:/opt/aerospike/data -v /opt/aerospike/etc:/opt/aerospike/etc/ --name aerospike -p 3000-3002:3000-3002 -e "FEATURE_KEY_FILE=/opt/aerospike/etc/features.conf" aerospike:ee-[version]

块存储配置

使用--device选项将主机块设备暴露给容器：

console
docker run -d --device '/dev/sdc:/dev/xvdc' -v /opt/aerospike/etc/:/opt/aerospike/etc/ --name aerospike -p 3000-3002:3000-3002 aerospike:ee-[version] --config-file /opt/aerospike/etc/aerospike.conf

对应的配置文件片段：

namespace test {
    storage-engine device {
        device /dev/xvdc
        write-block-size 128k
    }
}

持久化Lua缓存

挂载Lua目录以持久化缓存：

sh
docker run -d -v /opt/aerospike/lua:/opt/aerospike/usr/udf/lua -v /opt/aerospike/data:/opt/aerospike/data --name aerospike -p 3000-3002:3000-3002 -e "FEATURE_KEY_FILE=/opt/etc/aerospike/features.conf" aerospike:ee-[version]

集群配置

节点访问地址配置

在配置文件中设置access-address以确保节点能被集群中的其他节点访问：

network {
    service {
        address any
        port 3000
        access-address 192.168.1.100  # 集群节点和应用使用的IP地址
    }
}

集群搭建方法

1. 配置方式：在配置文件中设置每个节点的心跳信息
2. 命令方式：使用asinfo工具发送tip命令添加节点

镜像版本说明

• ee-[version]：企业版镜像，需要功能密钥文件，适用于商业许可用户
• ce-[version]：社区版镜像，无需功能密钥文件，适合开发和测试

所有镜像均基于ubuntu:24.04构建。

问题反馈

• 社区用户：在Aerospike讨论论坛发帖
• 企业用户：通过企业支持系统提交问题
• EE评估用户：在https://github.com/aerospike/aerospike-server-enterprise.docker/issues%E6%8F%90%E4%BA%A4issue
• CE用户：在https://github.com/aerospike/aerospike-server.docker/issues%E6%8F%90%E4%BA%A4issue

许可信息

• 商业企业许可用户：遵循Aerospike主许可协议
• EE评估用户：遵循Aerospike评估许可协议
• CE用户：参考https://github.com/aerospike/aerospike-server%E4%BB%93%E5%BA%93%E4%B8%AD%E7%9A%84%E8%AE%B8%E5%8F%AF%E4%BF%A1%E6%81%AF

使用本镜像即表示您同意所有包含软件的相关许可条款。