aerospike/aerospike-tools

Aerospike Tools Docker镜像文档

镜像概述和主要用途

本镜像包含Aerospike Tools的Dockerfile，提供了一套完整的容器化工具集，用于管理和操作Aerospike数据库集群。通过该镜像，用户可便捷地使用Aerospike官方工具进行集群监控、配置管理、数据备份恢复等操作，无需在本地环境单独安装工具依赖。

核心功能和特性

• 完整工具集：包含多种Aerospike管理工具，满足不同运维需求
• 容器化部署：通过Docker容器运行，简化环境配置和版本管理
• 灵活连接方式：支持直接连接指定主机或链接Aerospike容器

使用场景和适用范围

• Aerospike集群的日常监控与状态检查
• 数据库配置管理和参数调整
• 数据备份、恢复与迁移操作
• 性能分析与日志 latency 监控
• 开发、测试及生产环境中Aerospike集群的容器化管理

使用方法和配置说明

构建镜像

bash
DOCKER_BUILDKIT=1 docker build -t="aerospike/aerospike-tools" github.com/aerospike/aerospike-tools.docker

运行容器

方式1：连接到指定主机

直接连接到Aerospike集群的种子主机，需指定主机IP和工具命令。使用asadm时需添加--no-config-file选项。

bash
docker run -ti --name aerospike-tools aerospike/aerospike-tools <Aerospike工具命令> -h <种子主机IP>

示例：

bash
docker run -ti aerospike/aerospike-tools asadm -e "asinfo -v statistics" --no-config-file -h host1.example.aerospike.com

方式2：链接到Aerospike容器

通过--link选项链接到运行中的Aerospike容器，无需手动指定IP。

bash
docker run -ti --name aerospike-tools --link <容器名称>:aerospike aerospike/aerospike-tools <Aerospike工具命令>

示例：

bash
docker run -ti --link aerospike:aerospike aerospike/aerospike-tools asadm -e info --no-config-file

可用工具详情

• asinfo：集群信息查询工具
  asinfo -h SEED_HOST --no-config-file
• asadm：集群管理工具
  asadm -h SEED_HOST --no-config-file
• asloglatency：日志 latency 分析工具
  asloglatency -h SEED_HOST
• aql：Aerospike查询语言工具
  aql -h SEED_HOST --no-config-file
• asbackup：数据备份工具
  asbackup -h SEED_HOST --no-config-file
• asrestore：数据恢复工具
  asrestore -h SEED_HOST --no-config-file
• asbench：性能基准测试工具
  asbench -h SEED_HOST
• uda：用户定义函数管理工具
  uda -h SEED_HOST

更多工具使用详情可参考Aerospike官方工具文档。

支持的Docker版本

• 官方支持Docker版本：1.4.1
• 旧版本（低至1.0）提供尽力支持

用户反馈

问题反馈

如遇镜像使用问题或疑问，请通过以下渠道联系：

• Aerospike论坛
• https://github.com/aerospike/aerospike-tools.docker/issues

贡献方式

欢迎贡献新功能、修复或更新（无论大小）。提交PR前，建议通过论坛或GitHub Issues讨论计划，以便其他贡献者提供方向指导和设计反馈。