BB-786: trigger cold transition from oplog - #2830
Open
francoisferrand wants to merge 2 commits into
Open
Conversation
Contributor
Hello francoisferrand,My role is to assist you with the merge of this Available options
Available commands
Status report is not available. |
francoisferrand
changed the base branch from
development/9.0
to
development/9.6
August 25, 2026 12:58
Contributor
Branches have divergedThis pull request's source branch To avoid any integration risks, please re-synchronize them using one of the
Note: If you choose to rebase, you may have to ask me to rebuild |
Codecov Report❌ Patch coverage is
Additional details and impacted files
... and 4 files with indirect coverage changes
@@ Coverage Diff @@
## development/9.6 #2830 +/- ##
===================================================
- Coverage 76.13% 75.87% -0.27%
===================================================
Files 203 203
Lines 14029 14070 +41
===================================================
- Hits 10681 10675 -6
- Misses 3338 3385 +47
Partials 10 10
Flags with carried forward coverage won't be shown. Click here to find out more. 🚀 New features to boost your workflow:
|
francoisferrand
force-pushed
the
improvement/BB-786-direct-to-cold
branch
from
August 28, 2026 11:14
c10b011 to
02191ba
Compare
Contributor
Waiting for approvalThe following approvals are needed before I can proceed with the merge:
|
Support "direct-to-cold" transitions: when an object is uploaded with a cold storage class, cloudserver stores the data in the hot location and records the requested cold class in the object metadata, together with the transition-in-progress flag. The lifecycle queue populator now detects these objects from the oplog and publishes the cold archive request, reusing the whole existing transition pipeline. The transition-in-progress flag must not be cleared while requeuing such an object, since the flag (and the cold storage class) is what identifies it as pending a direct transition. Conversely, a bucket lifecycle rule must not transition an object which is already declared as cold. The metadata update completing the transition is stamped with a distinct 's3:LifecycleTransition:Direct' origin op, so that consumers can tell a direct transition from a lifecycle-driven one. Issue: BB-786
The queue populator parsed each oplog entry several times: once in filter() to look at the bucket, then again in every handler it may call. Each handler also re-checked the originOp it cares about, so the list of interesting operations was spread over the whole file. Decode the entry once in filter() and switch on the originOp there, passing the parsed value down. Handlers now only decide whether the object itself qualifies, which is what the new transition handler needs anyway. Issue: BB-786
francoisferrand
force-pushed
the
improvement/BB-786-direct-to-cold
branch
from
August 28, 2026 15:59
02191ba to
85b3f9f
Compare
DarkIsDude
requested changes
Aug 31, 2026
|
|
||
| // The object already exposes the location it is transitioned to, so this is a | ||
| // direct-to-cold transition. | ||
| const isDirect = objMD.getAmzStorageClass() === newLocation; |
There was a problem hiding this comment.
Should we move that to a dedicated function and avoid comment + code duplication ? Like something hasTargetedLocation ?
There was a problem hiding this comment.
(or better, return directly the target OriginOp ?)
| * @param {ObjectMD} md - object metadata | ||
| * @return {boolean} true if this is a pending direct transition | ||
| */ | ||
| _isDirectTransition(md) { |
There was a problem hiding this comment.
Suggested change
| _isDirectTransition(md) { | |
| _isDirectToColdTransition(md) { |
|
|
||
| // The object already exposes the location it is transitioned to, so this is a | ||
| // direct-to-cold transition. | ||
| const isDirect = objMD.getAmzStorageClass() === newLocation; |
There was a problem hiding this comment.
Suggested change
| const isDirect = objMD.getAmzStorageClass() === newLocation; | |
| const isDirectToCold = objMD.getAmzStorageClass() === newLocation; |
| /** | ||
| * Check whether the object transition was requested directly in the PUT request (as opposed | ||
| * to being triggered by a lifecycle rule): in that case the requested cold storage class is | ||
| * declared in the object metadata, while the data still lies in a hot location. |
There was a problem hiding this comment.
Suggested change
| * declared in the object metadata, while the data still lies in a hot location. | |
| * Check that the object is a direct to cold transition (without lifecycle trigger) |
The next of the description describe the inside of the function
| } | ||
| // Skip direct-to-cold objects, whose transition is triggered by the queue | ||
| // populator and require the transition in progress flag to be set | ||
| if (locationsConfig[objectMD.getAmzStorageClass()]?.isCold) { |
There was a problem hiding this comment.
| objectVersion: version, | ||
| requestId: uuid(), | ||
| size: value['content-length'], | ||
| eTag: value['content-md5'], |
There was a problem hiding this comment.
Should we add " ? Not sure about this one here
Comment on lines
+291
to
+292
| // if entry is a versioned object and is the master entry, skip task as | ||
| // the non-master entry will be processed |
There was a problem hiding this comment.
Suggested change
| // if entry is a versioned object and is the master entry, skip task as | |
| // the non-master entry will be processed | |
| // Skip it as the key will be processed by the non-master entry |
|
|
||
| // if entry is a versioned object and is the master entry, skip task as | ||
| // the non-master entry will be processed | ||
| if (this._isVersionedObject(value) && isMasterKey(entry.key)) { |
There was a problem hiding this comment.
This is a copy/paste, should we refactor that to have the logic at one place ?
Contributor
Waiting for approvalThe following approvals are needed before I can proceed with the merge:
The following reviewers are expecting changes from the author, or must review again: |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Support "direct-to-cold" transitions: an object uploaded with a cold storage class must end up archived in that cold location, without waiting for a lifecycle rule.
Cloudserver (out of scope here) stores the data in the hot location on such a PUT, and records the requested cold class in
x-amz-storage-classtogether with the transition-in-progress flag, while keeping the ordinary create origin op so that bucket notifications still fire.The lifecycle queue populator now detects these objects from the MongoDB oplog and publishes the cold archive request, reusing the exact message shape of
ReplicationAPI.sendDataMoverAction: the whole downstream pipeline (Sorbet -> cold status topic ->LifecycleColdStatusArchiveTask-> GC) is unchanged. The populator is strictly publish-only, and never writes object metadata. The discriminator only accepts origin ops that backbeat itself never writes, so a transition is never re-triggered by its own metadata updates; objects already holdingarchive.archiveInfoare excluded, while a pending deferred restore is not.The transition-in-progress flag must be kept when requeuing such an object, since that flag (together with the cold storage class) is precisely what identifies it as pending: clearing it would hide the object from the populator and break the retry loop after a single attempt. Conversely, a bucket lifecycle rule must not transition an object which is already declared as cold.
Finally, the metadata update completing the transition is stamped with a distinct
s3:LifecycleTransition:Directorigin op when the object already declared the target cold class, so consumers can tell a direct transition from a lifecycle-driven one.Issue: BB-786