mirror of https://github.com/rustfs/rustfs.git synced 2026-07-26 08:18:18 +00:00

Files

T

Henry Guo a63b79004c fix(scanner): make distributed usage convergence authoritative (#5151 )

* fix(scanner): make distributed usage cycles authoritative

* fix(scanner): close distributed refresh races

* fix(config): align scanner reload integration

* fix(admin): scope config test helpers

* fix(scanner): harden distributed usage convergence

* fix(scanner): preserve rolling activity compatibility

* fix(admin): expose non-secret optional config values

* fix(scanner): acknowledge distributed dirty usage

* fix(ecstore): make bucket mutations cancellation safe

* fix(scanner): preserve pending dirty acknowledgements

* test(obs): account for superseded scanner metric

* fix(api): reject excess detached bucket mutations

* test: close scanner convergence coverage gaps

* fix(scanner): make path tracking cleanup one-shot

---------

Co-authored-by: Henry Guo <marshawcoco@users.noreply.github.com>
Co-authored-by: houseme <housemecn@gmail.com>

2026-07-25 18:45:16 +08:00

src

fix(scanner): make distributed usage convergence authoritative (#5151 )

2026-07-25 18:45:16 +08:00

Cargo.toml

fix(ecstore): recover data usage snapshots safely (#4979 )

2026-07-17 19:02:16 +00:00

README.md

test(utils): add rustfs-test-utils crate and shared ECStore bootstrap (#4850 )

2026-07-15 16:08:30 +08:00

README.md

rustfs-test-utils

Shared bootstrap helpers for RustFS integration tests (backlog#1153 infra-1). Owns the "build a real temp-disk ECStore" setup that used to be copy-pasted across the heal/iam/scanner integration tests and had already drifted.

Usage

// [dev-dependencies] rustfs-test-utils = { workspace = true }
use rustfs_test_utils::TestECStoreEnv;

let env = TestECStoreEnv::builder()
    .prefix("rustfs_myfeature_test") // /tmp/<prefix>_<uuid>
    .disk_count(4)                   // single pool, single set
    .build()
    .await;

env.make_bucket("my-bucket", /* versioned = */ true).await;
// env.ecstore : Arc<ECStore>       — bootstrapped store
// env.disk_paths : Vec<PathBuf>    — disk1..diskN for fault injection
// env.temp_root : PathBuf          — root dir (leaked by design, see below)

Builder knobs:

disk_count(n) — disks in the single erasure set (default 4).
prefix(&str) — temp-dir prefix; a uuid suffix keeps parallel nextest processes isolated.
base_dir(path) — use a caller-owned directory (e.g. tempfile::TempDir) instead; the caller keeps cleanup ownership.
init_bucket_metadata(bool) — run init_bucket_metadata_sys after boot (default true; the IAM bootstrap test opts out).

init_tracing() is exposed separately and is called by build().

The environment does not delete temp_root on drop: a failed test's on-disk state stays inspectable, and heal tests keep manipulating disk_paths after setup. Own the directory via base_dir if you want automatic cleanup.

Constraints

dev-dependency only. No crate may list rustfs-test-utils under [dependencies] — test scaffolding must never reach production binaries.
Single-process integration scope. Multi-node / chaos harnesses are out of scope (backlog#1100). Scanner's lifecycle tests are absorbed only after ilm-1 activates them (they are #[ignore]d today).
All rustfs_ecstore imports stay behind src/ecstore_test_compat.rs — the sanctioned test-compat boundary pattern enforced by scripts/check_architecture_migration_rules.sh. Extend that module, never import the facade directly from other files.
Tests using this env bind 127.0.0.1:0 (random port) and unique temp dirs, so they stay parallel-safe under nextest's process-per-test model — do not add fixed ports or shared paths here. See docs/testing/README.md for the serial/nextest rules.