mirror of https://github.com/rustfs/rustfs.git synced 2026-07-27 16:48:58 +00:00

Files

T

Zhengchao An ce53feee87 test(lifecycle): regression test for expire/GET race (#3491 ) (#4706 )

Adds a serial-lane ILM integration regression test that pins the
local-first ordering contract established by rustfs#3491, where
`expire_transitioned_object` deletes local metadata BEFORE any remote
tier cleanup so a concurrent GET can never observe live local metadata
pointing at an already-removed remote tier version (user-visible
`NoSuchVersion`).

`serial_tests::test_expire_transitioned_object_never_races_concurrent_get`
in `crates/scanner/tests/lifecycle_integration_test.rs`:

- Transitions an object to a mock warm tier, then runs a tight
  concurrent GET loop while calling `expire_transitioned_object`; every
  GET must return a full, correct body or a clean object/version-not-found
  -- never a tier-fetch failure.
- Deterministic ordering assertion (revert-proof): immediately after
  expiry the remote tier object is still present and the mock recorded
  zero remote `remove` calls, proving remote cleanup is deferred to
  free-version recovery. Reverting to remote-first ordering turns this
  assertion red.

Supporting changes:
- Re-export `expire_transitioned_object` from `api::bucket::lifecycle`.
- Record remote-tier mutating ops in the scanner test `MockWarmBackend`.
- Update tier-ilm-debugging.md to reference the new regression test.

Runs in the CI ILM Integration (serial) lane (ci.yml
test-ilm-integration-serial), picked up by the existing
binary(lifecycle_integration_test) filter.

Refs: rustfs/backlog#1148 (ilm-2), rustfs/backlog#1155

2026-07-11 01:53:24 +00:00

src

fix(object-data-cache): make the GET key write-unique and dedup the lookup (#4693 )

2026-07-10 18:22:20 +00:00

tests

test(lifecycle): regression test for expire/GET race (#3491 ) (#4706 )

2026-07-11 01:53:24 +00:00

Cargo.toml

fix(runtime): remove tokio io-uring feature and add regression guard (#4364 )

2026-07-07 17:47:59 +08:00

README.md

docs(scanner): add benchmark runbook (#3412 )

2026-06-13 22:39:13 +08:00

README.zh-CN.md

docs(scanner): add benchmark runbook (#3412 )

2026-06-13 22:39:13 +08:00

README.md

RustFS Scanner

RustFS Scanner is the background maintenance scan loop. It handles usage accounting, lifecycle expiry and transition admission, bucket replication repair admission, scanner-driven heal/bitrot checks, and namespace alerts.

For operator-facing runtime controls, status fields, and tuning workflows, see Scanner Runtime Controls. For repeatable scanner-pressure validation, see Scanner Benchmark Runbook.

Chinese documentation is available in README.zh-CN.md.

Development

Build

cargo build --package rustfs-scanner

Test

cargo test --package rustfs-scanner

License

Apache License 2.0