Skip to content

Document the AbortIncompleteMultipartUpload lifecycle rule for write scatter - #90

Merged
aandraca-amazon merged 2 commits into
mainfrom
gh70-document-mpu-abort-lifecycle-rule
Oct 9, 2026
Merged

aandraca-amazon merged 2 commits into
mainfrom
gh70-document-mpu-abort-lifecycle-rule

Conversation

@aandraca-amazon

Copy link
Copy Markdown
Contributor

Document the AbortIncompleteMultipartUpload lifecycle rule for write scatter

A write scatter creates its own multipart upload directly against the
bucket, and the coordinating node holds the only upload ID. If that
coordinator dies before it reaches its own unwind path, the client has no ID
to abort the upload with, and the bucket keeps billing the orphaned parts
until something else removes them. ADR-0032 and a code comment on
coordinate::unwind already said the bucket needs an
AbortIncompleteMultipartUpload lifecycle rule for exactly this case, but no
user-facing doc did.

Add that guidance to the install requirements and to the write-scatter
design notes, with an example lifecycle configuration and a suggested expiry
for both general-purpose (Standard) buckets and S3 Express One Zone
directory buckets, and print a reminder in helm install's NOTES.txt
whenever the scatter resolves to enabled. A new chart test asserts the
notice appears exactly when it should.

Fix yamllint brace spacing in the write-scatter NOTES.txt test

Fixes #70

…scatter

A write scatter creates its own multipart upload directly against the
bucket, and the coordinating node holds the only upload ID. If that
coordinator dies before it reaches its own unwind path, the client has no ID
to abort the upload with, and the bucket keeps billing the orphaned parts
until something else removes them. ADR-0032 and a code comment on
coordinate::unwind already said the bucket needs an
AbortIncompleteMultipartUpload lifecycle rule for exactly this case, but no
user-facing doc did.

Add that guidance to the install requirements and to the write-scatter
design notes, with an example lifecycle configuration and a suggested expiry
for both general-purpose (Standard) buckets and S3 Express One Zone
directory buckets, and print a reminder in `helm install`'s NOTES.txt
whenever the scatter resolves to enabled. A new chart test asserts the
notice appears exactly when it should.
@aandraca-amazon
aandraca-amazon merged commit 45cb7b1 into main Oct 9, 2026
8 checks passed
@aandraca-amazon
aandraca-amazon deleted the gh70-document-mpu-abort-lifecycle-rule branch October 9, 2026 05:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document the lifecycle rule that aborts a scatter's orphaned multipart upload

1 participant