amd64/aerospike

** 注意 **：这是https://hub.docker.com/_/aerospike%E7%9A%84%60amd64%60%E6%9E%B6%E6%9E%84%E6%9E%84%E5%BB%BA%E7%9A%84%E2%80%9C%E6%8C%89%E6%9E%B6%E6%9E%84%E2%80%9D%E4%BB%93%E5%BA%93%E2%80%94%E2%80%94%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%A7%81%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%E6%96%87%E6%A1%A3%E4%B8%AD%E7%9A%84%E2%80%9Chttps://github.com/docker-library/official-images#architectures-other-than-amd64%E2%80%9D%E5%92%8C%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8FFAQ%E4%B8%AD%E7%9A%84%E2%80%9Chttps://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E2%80%9D%E3%80%82

快速参考

-** 维护者 **：
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/

-** 已发布镜像 artifact 详情 **：
https://github.com/docker-library/repo-info/blob/master/repos/aerospike (https://github.com/docker-library/repo-info/commits/master/repos/aerospike)
（镜像元数据、传输大小等）

-** 镜像更新 **：
https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Faerospike
https://github.com/docker-library/official-images/blob/master/library/aerospike (https://github.com/docker-library/official-images/commits/master/library/aerospike)

-** 本描述的来源 **：
https://github.com/docker-library/docs/tree/master/aerospike (https://github.com/docker-library/docs/commits/master/aerospike)

Aerospike数据库Docker镜像

什么是Aerospike？

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

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

快速开始

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地址
        }

Mesh集群

Mesh网络需要在集群中的每个节点之间建立链接。这可以通过两种方式实现：

1. 为集群中的每个节点添加配置，如网络心跳配置中所定义。
2. 使用asinfo发送tip命令，使节点知晓另一个节点，如asinfo中的tip命令中所定义。

更多信息，请参见如何在Docker中快速运行2节点Aerospike集群而无需编辑任何文件？

镜像版本

这些镜像基于https://hub.docker.com/_/ubuntu%E3%80%82

ee-[version]

这些标签用于Aerospike EE镜像，需要特征密钥文件（如单节点EE评估版或商业企业许可协议附带的密钥文件）。

ce-[version]

这些标签用于Aerospike CE镜像，启动时不需要特征密钥文件。如前所述，两者的开发人员API相同，但版本在操作功能上有所不同。

报告问题

如果您对该镜像有任何问题或疑问，请在Aerospike讨论论坛上发帖。

企业客户欢迎参与社区论坛，但也可以通过企业支持系统报告问题。

Aerospike EE评估用户可在https://github.com/aerospike/aerospike-server-enterprise.docker/issues%E4%B8%AD%E6%8F%90%E4%BA%A4%E9%97%AE%E9%A2%98%E3%80%82

Aerospike CE用户可在[aerospike/aerospike-server.docker](https://github.com/aerosp