
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
[***]
!aerospike_square_logo
Aerospike企业版美国联邦需要功能密钥文件才能启动,并解锁数据库中的某些功能(如压缩)。美国联邦企业版客户可使用其生产或开发密钥。
任何人都可以https://www.aerospike.com/lp/try-now/%E8%8E%B7%E5%8F%96%E8%AF%84%E4%BC%B0%E5%8A%9F%E8%83%BD%E5%AF%86%E9%92%A5%E6%96%87%E4%BB%B6%EF%BC%8C%E4%BB%A5%E4%BD%BF%E7%94%A8%E5%85%A8%E5%8A%9F%E8%83%BD%E7%9A%84%E5%8D%95%E8%8A%82%E7%82%B9Aerospike%E4%BC%81%E4%B8%9A%E7%89%88%E7%BE%8E%E5%9B%BD%E8%81%94%E9%82%A6%E3%80%82
shdocker run -d -v DIR:/opt/aerospike/etc/ -e "FEATURE_KEY_FILE=/opt/aerospike/etc/features.conf" --name aerospike -p 3000-3002:3000-3002 container.aerospike.com/aerospike/aerospike-server-federal
shdocker run -d -v DIR:/opt/aerospike/etc/ -e "FEATURE_KEY_FILE=/opt/aerospike/etc/features.conf" --name aerospike -p 3000-3002:3000-3002 container.aerospike.com/aerospike/aerospike-server-federal
上述命令中,DIR是您机器上放置功能密钥文件的目录。确保Docker Desktop具有文件共享权限,以便将其绑定挂载到Docker容器中。
shFEATKEY=$(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 container.aerospike.com/aerospike/aerospike-server-federal
您可以使用最新的aerospike-tools镜像连接到Aerospike容器。
shdocker run -ti docker.xuanyuan.run/aerospike/aerospike-tools:latest aql -h $(docker inspect -f '{{.NetworkSettings.IPAddress }}' aerospike) Seed: 172.17.0.2 User: None Config File: /etc/aerospike/astools.conf /root/.aerospike/astools.conf Aerospike Query Client Version 7.0.4 C Client Version 6.0.0 Copyright 2012-2021 Aerospike. All rights reserved. aql> show namespaces +------------+ | namespaces | +------------+ | "test" | +------------+ [172.17.0.2:3000] 1 row in set (0.002 secs) OK
shdocker run -ti docker.xuanyuan.run/aerospike/aerospike-tools:latest asadm -h $(docker inspect -f '{{.NetworkSettings.IPAddress }}' aerospike) Seed: [('172.17.0.2', 3000, None)] Config_file: /root/.aerospike/astools.conf, /etc/aerospike/astools.conf Aerospike Interactive Shell, version 2.10.0 Found 1 nodes Online: 172.17.0.2:3000 Admin> info ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~Network Information (2022-11-01 00:48:05 UTC)~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Node| Node ID| IP| Build|Migrations|~~~~~~~~~~~~~~~~~~Cluster~~~~~~~~~~~~~~~~~~|Client| Uptime | | | | |Size| Key|Integrity| Principal| Conns| 172.17.0.2:3000|*BB9020011AC4202|172.17.0.2:3000|F-6.1.0.3| 0.000 | 1|19E628721D9A|True |BB9020011AC4202| 8|00:02:09 Number of rows: 1 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~Namespace Usage Information (2022-11-01 00:48:05 UTC)~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Namespace| Node| Total|Expirations|Evictions| Stop|~~~~~~~~~~Device~~~~~~~~~~|~~~~~~~~~~Memory~~~~~~~~~|~Primary~ | |Records| | |Writes| Used|Used%|HWM%|Avail%| Used|Used%|HWM%|Stop%|~~Index~~ | | | | | | | | | | | | | | Type test |172.17.0.2:3000|0.000 | 0.000 | 0.000 |False |0.000 B | 0.0| 0| 99|0.000 B | 0.0| 0| 90|shmem test | |0.000 | 0.000 | 0.000 | |0.000 B | 0.0| | |0.000 B | 0.0| | | Number of rows: 1 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~Namespace Object Information (2022-11-01 00:48:05 UTC)~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Namespace| Node|Rack| Repl| Total|~~~~~~~~~~Objects~~~~~~~~~~|~~~~~~~~~Tombstones~~~~~~~~|~~~~Pending~~~~ | | ID|Factor|Records| Master| Prole|Non-Replica| Master| Prole|Non-Replica|~~~~Migrates~~~ | | | | | | | | | | | Tx| Rx test |172.17.0.2:3000| 0| 1|0.000 |0.000 |0.000 | 0.000 |0.000 |0.000 | 0.000 |0.000 |0.000 test | | | |0.000 |0.000 |0.000 | 0.000 |0.000 |0.000 | 0.000 |0.000 |0.000 Number of rows: 1
Aerospike FE Docker镜像附带默认配置文件,设置了单节点、单命名空间的开发环境。您也可以提供自己的配置文件(见下文)。
您可以使用-e标志通过容器端环境变量将参数注入默认配置模板。
例如,将默认https://docs.aerospike.com/server/architecture/data-model%E5%90%8D%E7%A7%B0%E8%AE%BE%E7%BD%AE%E4%B8%BA%60demo%60%EF%BC%9A
shdocker 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" container.aerospike.com/aerospike/aerospike-server-federal
将配置参数注入配置模板与提供配置文件不兼容,您只能使用其中一种方式。
FEATURE_KEY_FILE
service上下文中的https://docs.aerospike.com/server/operations/configure/feature-key%EF%BC%8C%E4%BB%85%E9%80%82%E7%94%A8%E4%BA%8E%E4%BC%81%E4%B8%9A%E7%89%88%EF%BC%8C%E8%BF%90%E8%A1%8C%E7%A4%BE%E5%8C%BA%E7%89%88%E6%97%B6%E5%BF%85%E9%A1%BB%E8%AE%BE%E7%BD%AE%E4%B8%BA%E7%A9%BA%E5%AD%97%E7%AC%A6%E4%B8%B2%E3%80%82%E9%BB%98%E8%AE%A4%E5%80%BC%EF%BC%9A%60/etc/aerospike/features.conf%60%E3%80%82
LOGFILE
logging上下文的https://docs.aerospike.com/reference/configuration#file%E5%8F%82%E6%95%B0%E3%80%82%E9%BB%98%E8%AE%A4%E5%80%BC%EF%BC%9A%60%22%22%60%EF%BC%8C%E4%B8%8D%E8%AE%B0%E5%BD%95%E5%88%B0%E6%96%87%E4%BB%B6%E3%80%82%E6%97%A0%E8%AE%BA%E6%AD%A4%E5%A4%84%E9%85%8D%E7%BD%AE%E5%A6%82%E4%BD%95%EF%BC%8C%E5%AE%B9%E5%99%A8%E9%83%BD%E4%BC%9A%E5%90%8C%E6%97%B6%E8%AE%B0%E5%BD%95%E5%88%B0%60stdout%60%E3%80%82
SERVICE_ADDRESS
networking.service子上下文的绑定https://docs.aerospike.com/reference/configuration#address%E3%80%82%E9%BB%98%E8%AE%A4%E5%80%BC%EF%BC%9A%60any%60%EF%BC%88%E4%BB%BB%E6%84%8F%E5%9C%B0%E5%9D%80%EF%BC%89
SERVICE_PORT
networking.service子上下文的https://docs.aerospike.com/reference/configuration#port%E3%80%82%E9%BB%98%E8%AE%A4%E5%80%BC%EF%BC%9A%603000%60
单个预配置命名空间具有以下变量:
NAMESPACE
命名空间名称。默认值:test
DATA_IN_MEMORY
存储引擎的https://docs.aerospike.com/reference/configuration#data-in-memory%E8%AE%BE%E7%BD%AE%E3%80%82%E5%A6%82%E6%9E%9C%E4%B8%BA%60false%60%EF%BC%88%E9%BB%98%E8%AE%A4%EF%BC%89%EF%BC%8C%E5%91%BD%E5%90%8D%E7%A9%BA%E9%97%B4%E4%BB%85%E5%B0%86%E7%B4%A2%E5%BC%95%E5%AD%98%E5%82%A8%E5%9C%A8%E5%86%85%E5%AD%98%E4%B8%AD%EF%BC%8C%E6%89%80%E6%9C%89%E8%AF%BB%E5%86%99%E6%93%8D%E4%BD%9C%E5%9D%87https://docs.aerospike.com/server/operations/configure/namespace/storage#recipe-for-a-persistent-memory-storage-engine%E3%80%82%E5%A6%82%E6%9E%9C%E4%B8%BA%60true%60%EF%BC%8C%E5%91%BD%E5%90%8D%E7%A9%BA%E9%97%B4%E5%AD%98%E5%82%A8%E4%B8%BAhttps://docs.aerospike.com/server/operations/configure/namespace/storage#recipe-for-an-hdd-storage-engine-with-data-in-memory%EF%BC%8C%E5%8D%B3%E8%AF%BB%E5%86%99%E6%93%8D%E4%BD%9C%E4%BB%8E%E5%AE%8C%E6%95%B4%E7%9A%84%E5%86%85%E5%AD%98%E5%89%AF%E6%9C%AC%E8%BF%9B%E8%A1%8C%EF%BC%8C%E5%90%8C%E6%AD%A5%E5%86%99%E5%85%A5%E4%BC%9A%E6%8C%81%E4%B9%85%E5%8C%96%E5%88%B0%E7%A3%81%E7%9B%98%E3%80%82
DEFAULT_TTL
命名空间的https://docs.aerospike.com/reference/configuration#default-ttl%E3%80%82%E9%BB%98%E8%AE%A4%E5%80%BC%EF%BC%9A%600%60
MEM_GB
命名空间的https://docs.aerospike.com/reference/configuration#memory-size%E3%80%82%E9%BB%98%E8%AE%A4%E5%80%BC%EF%BC%9A%601%60%EF%BC%8C%E5%8D%95%E4%BD%8D%E5%A7%8B%E7%BB%88%E4%B8%BA%60G%60%EF%BC%88GB%EF%BC%89
NSUP_PERIOD
命名空间的https://docs.aerospike.com/reference/configuration#nsup-period%E3%80%82%E9%BB%98%E8%AE%A4%E5%80%BC%EF%BC%9A%60120%60%EF%BC%8C%E5%8D%95%E4%BD%8D%E4%B8%BA%E7%A7%92%EF%BC%9B%E5%BD%93%60default-ttl%60%E4%B8%BA%600%60%E6%97%B6%E4%B9%9F%E4%BC%9A%E7%A6%81%E7%94%A8%E3%80%82
STORAGE_GB
命名空间持久性file的大小。默认值:4,单位始终为G(GB)
您可以通过提供自己的aerospike.conf文件覆盖默认配置文件,如https://docs.aerospike.com/server/operations/configure%E4%B8%AD%E6%89%80%E8%BF%B0%E3%80%82
您需要先使用-v映射本地目录,Docker会绑定挂载该目录。然后,将您的aerospike.conf文件放入此目录。最后,使用--config-file选项告知Aerospike容器中配置文件的位置(默认路径为/etc/aerospike/aerospike.conf)。请记住,功能密钥文件是必需的,因此在配置文件中使用feature-key-file指向挂载路径(如/opt/aerospike/etc/feature.conf)。
例如:
shdocker run -d -v /opt/aerospike/etc/:/opt/aerospike/etc/ --name aerospike -p 3000-3002:3000-3002 container.aerospike.com/aerospike/aerospike-server-federal --config-file /opt/aerospike/etc/aerospike.conf
Docker容器内的文件在容器生命周期结束后不会持久化。要持久化数据,需使用-v选项将主机目录挂载到容器的/opt/aerospike/data:
例如:
shdocker 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" container.aerospike.com/aerospike/aerospike-server-federal
上述示例使用配置模板,其中单个定义的命名空间是内存中带文件持久性的。只需挂载预定义的/opt/aerospike/data目录即可在主机上持久化数据。
或者,您的自定义配置文件可将file大小设置为挂载的/opt/aerospike/data中的文件,如下配置片段所示:
plaintextnamespace test { # : storage-engine device { file /opt/aerospike/data/test.dat filesize 4G data-in-memory true } }
在此示例中,我们使用类似方式挂载数据目录,并使用自定义配置文件:
shdocker run -d -v /opt/aerospike/data:/opt/aerospike/data -v /opt/aerospike/etc/:/opt/aerospike/etc/ --name aerospike -p 3000-3002:3000-3002 container.aerospike.com/aerospike/aerospike-server-federal --config-file /opt/aerospike/etc/aerospike.conf
Docker允许将主机的块设备暴露给运行中的容器。可使用--device选项在容器内映射主机块设备。
更新自定义Aerospike配置文件中命名空间的storage-engine device部分:
plaintextnamespace test { # : storage-engine device { device /dev/xvdc write-block-size 128k } }
现在将主机驱动器/dev/sdc映射到容器的/dev/xvdc:
shdocker run -d --device '/dev/sdc:/dev/xvdc' -v /opt/aerospike/etc/:/opt/aerospike/etc/ --name aerospike -p 3000-3002:3000-3002 container.aerospike.com/aerospike/aerospike-server-federal --config-file /opt/aerospike/etc/aerospike.conf
重启后,Lua缓存将被清空。要持久化缓存,需使用-v选项将主机目录挂载到容器的/opt/aerospike/usr/udf/lua:
shdocker 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 container.aerospike.com/aerospike/aerospike-server-federal --config-file /opt/aerospike/etc/aerospike.conf
为方便起见,此镜像默认未启用安全功能,但这是Aerospike企业版的核心功能。知识库文章https://discuss.aerospike.com/t/how-to-secure-aerospike-database-servers/7804%E8%AF%A6%E7%BB%86%E4%BB%8B%E7%BB%8D%E4%BA%86%E8%AF%A5%E4%B8%BB%E9%A2%98%E3%80%82
https://www.aerospike.com/blog/and-now-for-a-security-reminder/%EF%BC%9A%E5%AE%89%E5%85%A8%E9%97%AE%E9%A2%98%E5%8F%AF%E8%83%BD%E5%BD%B1%E5%93%8D%E4%BB%BB%E4%BD%95%E7%94%A8%E6%88%B7%E3%80%82
另请参见知识库文章https://discuss.aerospike.com/t/how-to-secure-aerospike-database-servers/7804%E3%80%82
使用Aerospike FE单节点评估的开发人员,以及大多数在其机器上使用Docker Desktop进行开发的用户,无需配置节点进行集群。如果您有兴趣使用集群,且功能密钥文件没有单节点限制,或者使用社区版,请阅读以下部分。
配置节点的访问地址
为使Aerospike节点正确向集群和应用广播其地址,需在配置文件中设置https://docs.aerospike.com/reference/configuration#access-address%E9%85%8D%E7%BD%AE%E5%8F%82%E6%95%B0%E3%80%82%E5%A6%82%E6%9E%9C%E6%9C%AA%E8%AE%BE%E7%BD%AE%EF%BC%8C%E5%B0%86%E4%BD%BF%E7%94%A8%E5%AE%B9%E5%99%A8%E5%86%85%E7%9A%84IP%E5%9C%B0%E5%9D%80%EF%BC%8C%E5%85%B6%E4%BB%96%E8%8A%82%E7%82%B9%E6%97%A0%E6%B3%95
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务