mirror of https://github.com/rustfs/rustfs.git synced 2026-08-07 22:03:14 +00:00

Files

T

cxymds 294c79c156 fix(tiering): gate remote version state safely (#5374 )

* feat(tiering): model provider version capabilities

* feat(tiering): persist opaque remote versions

* fix(tiering): gate remote version state safely

* fix(tiering): preserve remote version state on delete

* fix(tiering): accept unversioned transition responses

* fix(tiering): replay exact cleanup journals

* test(tiering): pin empty exact cleanup guard

* test(tiering): accept strict missing journal errors

* test(tiering): exercise free-version identity guard

* test(tiering): reach destination identity guard

* test(tiering): persist version identity drift

* test(tiering): bind version drift fixture

---------

Co-authored-by: houseme <housemecn@gmail.com>

2026-07-29 02:43:28 +00:00

bucket_lifecycle_audit.rs

refactor(lifecycle): route events through audit sink (#4066 )

2026-06-29 22:21:23 +08:00

bucket_lifecycle_ops.rs

fix(tiering): gate remote version state safely (#5374 )

2026-07-29 02:43:28 +00:00

config_boundary.rs

fix(ilm): fail closed on unsafe manual recovery (#5276 )

2026-07-26 07:36:58 +00:00

core.rs

refactor(lifecycle): extract core rule contracts (#4258 )

2026-07-04 20:05:56 +08:00

evaluator.rs

refactor(lifecycle): extract core rule contracts (#4258 )

2026-07-04 20:05:56 +08:00

manual_transition_job.rs

fix(sts): return Query API-compatible responses (#5282 )

2026-07-28 10:39:17 +08:00

metadata_boundary.rs

refactor(ecstore): route lifecycle metadata reads (#4111 )

2026-06-30 15:22:12 +08:00

mod.rs

feat(ilm): add durable manual transition job store (#5229 )

2026-07-25 14:54:14 +00:00

object_lock_boundary.rs

refactor(lifecycle): extract core rule contracts (#4258 )

2026-07-04 20:05:56 +08:00

README.md

refactor(runtime): batch owner boundary guards (#4092 )

2026-06-30 04:34:54 +08:00

replication_sink.rs

refactor(replication): own filemeta wire contracts (#4254 )

2026-07-04 06:39:54 +08:00

rule.rs

refactor(lifecycle): extract core rule contracts (#4258 )

2026-07-04 20:05:56 +08:00

runtime_boundary.rs

refactor(ecstore): migrate the background-services cancel token into InstanceContext (Phase 5 Slice 13) (#4586 )

2026-07-08 22:06:31 +00:00

tagging_boundary.rs

refactor(lifecycle): add tagging boundary (#4082 )

2026-06-30 03:39:32 +08:00

tier_delete_journal.rs

fix(tiering): gate remote version state safely (#5374 )

2026-07-29 02:43:28 +00:00

tier_free_version_recovery.rs

fix(lifecycle): stop tier free-version recovery walk-timeout loop (#5194 )

2026-07-26 02:54:33 +00:00

tier_last_day_stats.rs

refactor(s3): consolidate semantic boundaries and remove s3-common (#3012 )

2026-05-19 12:50:25 +00:00

tier_sweeper.rs

fix(tiering): gate remote version state safely (#5374 )

2026-07-29 02:43:28 +00:00

transition_transaction.rs

fix(tiering): gate remote version state safely (#5374 )

2026-07-29 02:43:28 +00:00

README.md

ECStore Lifecycle Split Inventory

This directory still belongs to ECStore. It is not ready to become a standalone crate because lifecycle workers currently depend on ECStore runtime state, object IO, bucket metadata, replication scheduling, notification/audit sinks, and tier services.

Current Modules

Module	Current role	Split blocker
`core.rs`	Lifecycle rule model, action evaluation, object options, and transition/expiry decisions.	Uses ECStore object metadata types and compatibility DTO re-exports.
`bucket_lifecycle_ops.rs`	Worker orchestration, expiry, transition, stale multipart cleanup, audit, replication delete scheduling, and queue state.	Depends on `ECStore`, `SetDisks`, runtime globals, bucket metadata/versioning, disk internals, event notification, tier services, and lifecycle-local object-lock/replication boundaries.
`evaluator.rs`	Bucket lifecycle evaluation wrapper.	Uses lifecycle-local object-lock boundary and replication state through lifecycle-local replication sink.
`rule.rs`	Lifecycle rule filter helpers.	Uses lifecycle-local tagging boundary.
`tier_delete_journal.rs`	Remote tier delete journal persistence and recovery.	Uses lifecycle-local config persistence boundary, object IO contracts, metadata bucket paths, and `ECStore`.
`tier_free_version_recovery.rs`	Free-version recovery queue and object restoration path.	Depends on `ECStore`, object metadata, storage-api contracts, and lifecycle queue callbacks.
`tier_last_day_stats.rs`	Tier statistics helpers.	Pure data/stat logic, but still part of lifecycle worker reporting.
`tier_sweeper.rs`	Remote tier deletion worker and transition cleanup.	Depends on runtime sources, `ECStore`, tier journal persistence, signer-error handling, and lifecycle object options.
`bucket_lifecycle_audit.rs`	Lifecycle audit event source labels.	Must remain wired to lifecycle audit and notification sinks.

Required Contracts

Contract	Responsibility	Current dependency to remove
`LifecycleObjectStore`	Object stat, delete, transition, restore, multipart cleanup, and version-aware metadata operations.	Direct `ECStore`, `SetDisks`, disk, and object API access in worker paths.
`LifecycleMetadataStore`	Lifecycle, object-lock, replication, bucket versioning, and stale multipart metadata reads.	Direct bucket metadata/versioning imports; object-lock and replication are still backed by local ECStore boundaries.
`LifecycleRuntime`	Expiry state, transition state, tier config, deployment ID, local node name, queue metrics, cancellation, and worker sizing.	Direct runtime source/global access and process environment reads inside worker code.
`LifecycleConfigStore`	Persist, read, and remove lifecycle-owned journal/config objects.	Direct ECStore config persistence helper imports from worker paths.
`LifecycleTagFilter`	Decode object tag strings for lifecycle rule matching.	Direct bucket tagging helper imports from lifecycle rule paths.
`LifecycleObjectLockStore`	Object-lock retention and deletion checks used by lifecycle evaluation and worker deletion paths.	Direct object-lock module imports from lifecycle code.
`LifecycleReplicationSink`	Lifecycle-originated delete and version-purge replication scheduling.	Boundary is local, but still backed by ECStore bucket replication internals.
`LifecycleAuditSink`	Lifecycle audit and notification event emission.	Direct event notification service calls and audit-side effects from worker code.

Migration Rules

Do not move bucket/lifecycle into a new crate while any worker imports crate::store::ECStore, crate::set_disk::SetDisks, runtime globals, or bucket replication internals directly.
Extract pure contracts before runtime movement. The first code-bearing PR should introduce one contract boundary and keep the old ECStore call path.
Preserve lifecycle queue behavior, transition/expiry state, replication delete scheduling, notification/audit events, scanner-visible metrics, and stale multipart cleanup semantics.
Keep rustfs_ecstore::api::bucket::lifecycle compatibility until scanner, OBS, and test boundary files compile through replacement paths.
Verify each code-bearing step with focused lifecycle tests before attempting broad gates.

First Code-Bearing Step

Start with LifecycleRuntime or LifecycleAuditSink. Both can be introduced as narrow internal contracts while keeping the current ECStore worker behavior unchanged. Do not start with a crate move.

Current first boundary: runtime_boundary.rs centralizes lifecycle access to runtime state while preserving the existing ECStore-backed implementations. config_boundary.rs centralizes lifecycle-owned config object persistence for tier delete journal recovery while preserving the existing ECStore config store. tagging_boundary.rs centralizes lifecycle tag decoding while preserving the existing ECStore bucket tagging implementation. object_lock_boundary.rs centralizes lifecycle object-lock checks while preserving the existing ECStore object-lock implementation. replication_sink.rs centralizes lifecycle-originated replication config checks and delete scheduling while preserving the existing ECStore replication worker path.