Files
milvus/tests/README_CN.md
T
8f09efda8f test: expand CDC replication test coverage across features and chaos scenarios (#49043)
## Summary

Extends the CDC (replication) e2e test suite with comprehensive
cross-feature coverage and switchover/failover scenarios on top of
#45624.

## What's Added

### New test files (\`tests/python_client/cdc/testcases/\`)
- \`test_fts_and_text.py\` — BM25 search, text_match, phrase_match,
hybrid FTS+dense, FTS after switchover (5 tests × 2 analyzers)
- \`test_schema_features.py\` — dynamic schema, nullable, defaults,
partition key, clustering key, combined features (7 tests)
- \`test_collection_properties.py\` — TTL, mmap, autocompaction,
multi-property, drop property (5 tests)
- \`test_resource_group.py\` — create, drop, update, transfer replica (4
tests)
- \`test_multi_database.py\` — cross-DB collections, drop DB with
collections, cross-DB operations (3 tests)
- \`test_search_verification.py\` — 6 tests × 7 vector types (search
result consistency, query data sampling, hybrid search, iterators,
filtered search)
- \`test_switchover.py\` — basic, during-writes, all-types, loaded,
indexed, rapid stress, failover (7 tests)

### Shared utilities
- \`base.py\`: +7 schema factories, +4 data generators, +4 verification
helpers, +2 constants
- \`conftest.py\`: +\`switchover_helper\` fixture,
+\`--is-check\`/\`--milvus-ns\` options

## Test plan
- [ ] Run \`pytest tests/python_client/cdc/testcases/\` against
two-cluster CDC deployment
- [ ] Verify each test file runs independently via \`pytest
testcases/test_<name>.py\`
- [ ] Companion PR in zilliztech/test-jobs adds Jenkins pipelines to run
these

issue: #49042
pr: #45624

/kind test
/kind improvement

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Signed-off-by: Yihao Dai <yihao.dai@zilliz.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-28 10:29:50 +08:00

4.5 KiB
Raw Blame History

Tests

E2E Test

配置清单

操作系统
操作系统 版本
CentOS 7.5 或以上
Ubuntu 16.04 或以上
Mac 10.14 或以上
硬件
硬件名称 建议配置
CPU x86_64 平台
Intel CPU Sandy Bridge 或以上
CPU 指令集
- SSE4_2
- AVX
- AVX2
- AVX512
内存 16 GB 或以上
软件
软件名称 版本
Docker 19.05 或以上
Docker Compose 1.25.5 或以上
jq 1.3 或以上
kubectl 1.14 或以上
helm 3.0 或以上
kind 0.10.0 或以上

安装依赖

检查 Docker 和 Docker Compose 状态
  1. 确认 Docker Daemon 正在运行:
$ docker info
  • 安装 Docker 步骤见 Docker CE/EE 官方安装说明进行安装

  • 如果无法正常打印 Docker 相关信息,请启动 Docker Daemon。

  • 要在没有 root 权限的情况下运行 Docker 命令,请创建 docker 组并添加用户,以运行:sudo usermod -aG docker $USER, 退出终端并重新登录,以使更改生效 ,详见 使用非 root 用户管理 docker

  1. 确认 Docker Compose 版本
$ docker compose version

docker compose version 1.25.5, build 8a1c60f6
docker-py version: 4.1.0
CPython version: 3.7.5
OpenSSL version: OpenSSL 1.1.1f  31 Mar 2020
安装 jq
安装 kubectl
安装 helm
安装 kind

运行 E2E Test

$ cd tests/scripts
$ ./e2e-k8s.sh

Getting help

你可以执行以下命令获取帮助

$ ./e2e-k8s.sh --help

Python 代码质量 (ruff)

Ruff 配置位于 tests/ruff.toml,覆盖 tests/ 下所有 Python 代码 python_client/restful_client/restful_client_v2/benchmark/scripts/)。 各子目录的运行时依赖仍通过各自的 requirements.txt 管理。

$ cd tests/
$ ruff check .                  # lint 检查
$ ruff check . --fix            # lint 检查并自动修复
$ ruff format .                 # 原地格式化
$ ruff format --check .         # 只检查不修改 (CI 友好)

启用的规则:EFWIUP;目标 Python 版本:3.10

仅检查 PR 修改的文件 (与 Python Lint CI 一致)

GitHub Actions workflow .github/workflows/python-lint.yaml job "Python Lint (tests/) / Ruff (changed files only)" 只对 PR 修改的 tests/**/*.py 文件跑 ruff checkruff format --check。 直接对整个 tests/ 目录执行 uv run ruff check . 太粗——很多历史文件早于 当前 lint 配置,会因为无关规则失败。

要在本地复现 CI 这一步,使用本目录下的 Makefile

$ cd tests/
$ make ci             # 对 PR 修改文件跑 ruff check + format --check(与 CI 等价)
$ make lint-fix       # 对 PR 修改文件跑 ruff check --fix
$ make format         # 对 PR 修改文件跑 ruff format
$ make help           # 显示所有 target 以及当前自动检测到的 BASE_REF

BASE_REF 通过 gh pr view 从当前分支的开放 PR 中自动检测: 解析 PR URL 得到 base <owner>/<repo>,再匹配本地 git remotes, 得到形如 upstream/masterupstream/2.x 或(直接 clone 主仓库时的) origin/main

如果当前分支没有开放 PR必须显式设置 BASE_REF (不再做猜测——base 选错会 diff 出无关 commit):

$ make ci BASE_REF=upstream/master

需要本地已安装 uv(提供 uvx)和已认证的 gh gh auth status)。Makefile 通过 RUFF_VERSION 锁定与 workflow 一致的 ruff 版本。