scylladb/gemini
scylladb
这是一个针对ScyllaDB和Apache Cassandra集群的自动随机测试套件，通过在参考Oracle集群与被测系统上同时运行随机工作负载，验证数据完整性并报告差异。
下载次数: 0状态：社区镜像维护者：scylladb仓库类型：镜像最近更新：3 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
!https://github.com/scylladb/gemini/raw/master/docs/images/gemini.png
Scylla和Apache Cassandra的自动随机测试套件。
什么是Gemini？
Gemini是一款用于测试ScyllaDB（及Apache Cassandra）集群的工具，通过同时对参考“Oracle”集群和被测系统（SUT）运行随机工作负载实现验证。它生成随机突变操作（INSERT、UPDATE、DELETE），并通过SELECT查询对比结果；当Oracle与被测系统出现差异时，Gemini会报告差异以供调查。
快速开始
安装
从https://github.com/scylladb/gemini/releases%E4%B8%8B%E8%BD%BD%E9%80%82%E7%94%A8%E4%BA%8E%E6%82%A8%E5%B9%B3%E5%8F%B0%E7%9A%84%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC%EF%BC%9A
- Linux（amd64、arm64）
- Docker：
scylladb/gemini:latest（支持amd64和arm64）
Oracle集群规格建议
Oracle集群作为验证的事实来源，需满足：
- 推荐单节点：避免最终一致性导致的假阳性
- 资源分配：至少为被测集群单节点的2倍CPU/RAM
- 复制因子适配：若被测集群RF小于节点数，按比例增加Oracle资源
- 一致性级别：建议使用
--consistency=QUORUM或ALL减少复制延迟问题
快速启动命令
bash# 双集群测试（Oracle + 被测） ./gemini --oracle-cluster=<ORACLE_IP> --test-cluster=<TEST_IP> # 仅测试模式（无Oracle验证） ./gemini --test-cluster=<TEST_IP> # Docker运行 docker run -it scylladb/gemini:latest \ --oracle-cluster=<ORACLE_IP> \ --test-cluster=<TEST_IP>
基本选项
bash./gemini \ --test-cluster=192.168.1.10,192.168.1.11 \ --oracle-cluster=192.168.1.20 \ --duration=1h \ --concurrency=10 \ --mode=mixed
查看./gemini --help或https://github.com/scylladb/gemini/blob/master/docs/cli-arguments.md%E8%8E%B7%E5%8F%96%E5%AE%8C%E6%95%B4%E9%80%89%E9%A1%B9%E3%80%82
核心功能
已支持特性
- 随机Schema生成：自动生成含多种列类型、分区键和聚类键的表结构
- 多操作模式：仅写、只读或混合工作负载
- 分区键分布：均匀、正态、Zipf分布模拟真实访问
- 计数器支持：
--use-counters测试计数器表 - 轻量级事务：
--use-lwt启用LWT功能 - 语句日志：捕获执行语句用于调试
- 自定义语句比例：微调插入/更新/删除/查询分布
- Prometheus指标：端口2112提供指标端点
- 认证支持：用户名/密码认证双集群
- 日志压缩：gzip/zstd压缩语句日志
- 可配置并发：独立控制突变和查询并发
- 预热期：验证前可选预热阶段
- 可重现运行：
--seed和--schema-seed重放测试场景
操作模式
| 模式 | 描述 |
|---|---|
mixed | （默认）同时执行突变和验证 |
write | 仅突变操作，无验证查询 |
read | 仅对现有数据执行验证查询 |
故障处理
检测到差异时，错误会通过以下方式报告：
- 控制台/stdout：即时输出
- gemini.log：JSON格式完整日志
- 语句日志：若启用，捕获语句用于重放 详细调试参见https://github.com/scylladb/gemini/blob/master/docs/investigation.md%E3%80%82
文档
- https://github.com/scylladb/gemini/blob/master/docs/quickref.md%EF%BC%9A%E5%B8%B8%E7%94%A8%E5%91%BD%E4%BB%A4%E4%B8%8E%E9%80%89%E9%A1%B9
- https://github.com/scylladb/gemini/blob/master/docs/schema.md%EF%BC%9A%E8%87%AA%E5%AE%9A%E4%B9%89Schema
- https://github.com/scylladb/gemini/blob/master/docs/metrics.md%EF%BC%9APrometheus%E6%8C%87%E6%A0%87%E8%AF%B4%E6%98%8E
- https://github.com/scylladb/gemini/blob/master/docs/troubleshooting.md%EF%BC%9A%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98%E8%A7%A3%E5%86%B3
贡献
欢迎Fork仓库并提交Pull Request，参见https://github.com/scylladb/gemini/blob/master/docs/development.md%E3%80%82
许可证
Apache 2.0 - 参见https://github.com/scylladb/gemini/blob/master/LICENSE%E3%80%82
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull scylladb/gemini:<标签>
更多 gemini 镜像推荐
adrianhesketh/gemini
adrianhesketh
A Gemini server (github.com/a-h/gemini)
10万+ 次下载
4 年前更新
champtitles/gemini
champtitles
暂无描述
1万+ 次下载
2 年前更新
apecloud/gemini
apecloud
暂无描述
1万+ 次下载
1 个月前更新
mcp/gemini-api-docs
mcp（Model Context Protocol）
Provides tools to search and retrieve Google Gemini API documentation.
1 次收藏1万+ 次下载
7 个月前更新
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"