amd64/aerospike Docker Image Overview

amd64/aerospike

amd64

Aerospike是一款可靠、高性能的分布式数据库，专为闪存和RAM优化，支持键值和文档数据模型，具备混合内存架构，能在大规模应用中提供可预测的高性能。

0 次下载

🚀 稳定镜像源 = 更少宕机 + 更低运维成本

中文简介版本下载

🚀 稳定镜像源 = 更少宕机 + 更低运维成本

** 注意 **：这是aerospike官方镜像的amd64架构构建的“按架构”仓库——更多信息，请参见官方镜像文档中的“非amd64架构？”和官方镜像FAQ中的“Git中的镜像源已更改，该怎么办？”。

快速参考

-** 维护者 **：
Aerospike, Inc.

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

支持的标签及对应的`Dockerfile`链接

ee-8.1.0.1, ee-8.1.0.1_1
ce-8.1.0.1, ce-8.1.0.1_1

快速参考（续）

-** 提交问题 **：
Aerospike论坛或 GitHub

-** 支持的架构 **：(更多信息)
amd64、arm64v8

-** 已发布镜像 artifact 详情 **：
repo-info仓库的repos/aerospike/目录 (历史记录)
（镜像元数据、传输大小等）

-** 镜像更新 **：
official-images仓库的library/aerospike标签
official-images仓库的library/aerospike文件 (历史记录)

-** 本描述的来源 **：
docs仓库的aerospike/目录 (历史记录)

Aerospike数据库Docker镜像

什么是Aerospike？

Aerospike是一款专为高性能Web规模应用设计的分布式NoSQL数据库。Aerospike支持键值和文档数据模型，并具有多种数据类型，包括列表、映射、HyperLogLog、GeoJSON和二进制大对象（Blob）。Aerospike的专利混合内存架构在大规模场景下提供可预测的高性能和高节点数据密度。

!logo

快速开始

Aerospike企业版（EE）需要特征密钥文件才能启动并解锁数据库中的某些功能（如压缩）。企业客户可以使用其生产或开发密钥。

任何人都可以注册获取评估特征密钥文件，以使用全功能的单节点Aerospike企业版。

Aerospike社区版（CE）支持与企业版相同的开发人员API，但在操作便捷性和企业功能方面有所不同。更多信息请参见产品矩阵。

在映射目录中使用特征密钥文件运行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 amd64/aerospike:ee-[version]

上述命令中，DIR是您机器上放置特征密钥文件的目录。确保Docker Desktop具有文件共享权限，以便将其绑定挂载到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 amd64/aerospike:ee-[version]

运行Aerospike CE节点

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

高级配置

Aerospike Docker镜像有一个默认配置文件模板，可通过单独的配置参数进行填充（如前面使用FEATURE_KEY_FILE）。或者，也可以用自定义配置文件替换它。

以下部分描述了这两种高级选项。

注入配置参数

您可以使用-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" amd64/aerospike:ee-[version]

将配置参数注入配置模板与使用自定义配置文件不兼容，只能选择其中一种方式。

模板变量列表

FEATURE_KEY_FILE - feature_key_file（仅EE镜像需要）。默认值：/etc/aerospike/features.conf
SERVICE_THREADS - service_threads。默认值：vCPU数量
LOGFILE - logging上下文的file参数。默认值：/dev/null（不记录到文件，记录到stdout）
SERVICE_ADDRESS - networking.service子上下文的绑定address。默认值：any（任意地址）
SERVICE_PORT - networking.service子上下文的port。默认值：3000
HB_ADDRESS - 跨集群网格的networking.heartbeat``address。默认值：any（任意地址）
HB_PORT - networking.heartbeat通信的port。默认值：3002
FABRIC_ADDRESS - networking.fabric子上下文的address。默认值：any（任意地址）
FABRIC_PORT - networking.fabric子上下文的port。默认值：3001

单个预配置的命名空间是内存中带文件系统持久化的。

NAMESPACE - 命名空间名称。默认值：test
REPL_FACTOR - 命名空间replication-factor。默认值：2
MEM_GB - 命名空间memory-size。默认值：1（单位始终为G（GB））
DEFAULT_TTL - 命名空间default-ttl。默认值：30d
STORAGE_GB - 命名空间持久化file大小。默认值：4（单位始终为G（GB））
NSUP_PERIOD - 命名空间nsup-period。默认值：120（单位：秒）

使用自定义配置文件

您可以通过提供自己的aerospike.conf（如Aerospike数据库配置中所述）来覆盖配置文件模板的使用。

首先，使用-v映射本地目录，Docker将绑定挂载该目录。然后，将您的aerospike.conf文件放入此目录。最后，使用--config-file选项告诉Aerospike配置文件在容器中的位置（默认路径为/etc/aerospike/aerospike.conf）。请记住，特征密钥文件是必需的，因此在配置文件中使用feature-key-file指向挂载路径（如/opt/aerospike/etc/feature.conf）。

例如：

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

持久化数据目录

使用Docker时，容器内的文件不会在容器生命周期结束后持久化。要持久化数据，需要使用-v选项将主机目录挂载到容器的/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" amd64/aerospike:ee-[version]

上述示例使用配置模板，其中单个定义的命名空间是内存中带文件持久化的。只需挂载预定义的/opt/aerospike/data目录即可在主机上持久化数据。

或者，使用自定义配置文件，将file参数设置为挂载的/opt/aerospike/data中的文件，如下配置片段所示：

namespace test {
    # :
    storage-engine device {
        file /opt/aerospike/data/test.dat
        filesize 4G
        data-in-memory true
    }
}

在此示例中，我们也以类似方式挂载数据目录，并使用自定义配置文件：

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 amd64/aerospike:ee-[version] --config-file /opt/aerospike/etc/aerospike.conf

块存储

Docker提供了将主机块设备暴露给运行中容器的能力。可使用--device选项在容器内映射主机块设备。

更新自定义aerospike配置文件中命名空间的storage-engine device部分：

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

现在将主机驱动器/dev/sdc映射到容器的/dev/xvdc：

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

持久化Lua缓存

重启后，Lua缓存将被清空。要持久化缓存，需使用-v选项将主机目录挂载到容器的/opt/aerospike/usr/udf/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" amd64/aerospike:ee-[version]

集群

使用Aerospike EE单节点评估版的开发人员，以及大多数在其机器上使用Docker Desktop进行开发的人员，不需要为集群配置节点。如果您有兴趣使用集群且特征密钥文件没有单节点限制，请阅读以下部分。

配置节点的访问地址

为了使Aerospike节点能正确向集群和应用广播其地址，需要在配置文件中设置access-address配置参数。如果未设置，将使用容器内的IP地址，该地址对其他节点不可访问。

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