Skip to content

Commit 2030275

Browse files
committed
docs: release notes for curl-based s3
1 parent b100c3b commit 2030275

File tree

1 file changed

+36
-0
lines changed

1 file changed

+36
-0
lines changed
Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
---
2+
synopsis: "Improved S3 binary cache support via HTTP"
3+
prs: [13752]
4+
issues: [13084, 12671, 11748, 12403, 5947]
5+
---
6+
7+
S3 binary cache operations now happen via HTTP, leveraging `libcurl`'s native AWS
8+
SigV4 authentication instead of the AWS C++ SDK, providing significant
9+
improvements:
10+
11+
- **Reduced memory usage**: Eliminates memory buffering issues that caused
12+
segfaults with large files (>3.5GB)
13+
- **Fixed upload reliability**: Resolves AWS SDK chunking errors
14+
(`InvalidChunkSizeError`) during multipart uploads
15+
- **Resolved OpenSSL conflicts**: No more S2N engine override issues in
16+
sandboxed builds
17+
- **Lighter dependencies**: Uses lightweight `aws-crt-cpp` instead of full
18+
`aws-cpp-sdk`, reducing build complexity
19+
20+
The new implementation requires curl >= 7.75.0 and `aws-crt-cpp` for credential
21+
management.
22+
23+
All existing S3 URL formats and parameters remain supported.
24+
25+
## Breaking changes
26+
27+
The legacy `S3BinaryCacheStore` implementation has been removed in favor of the
28+
new curl-based approach.
29+
30+
**Migration**: No action required for most users. S3 URLs continue to work
31+
with the same syntax. Users directly using `S3BinaryCacheStore` class
32+
should migrate to standard HTTP binary cache stores with S3 endpoints.
33+
34+
**Build requirement**: S3 support now requires curl >= 7.75.0 for AWS SigV4
35+
authentication. Build configuration will warn if `aws-crt-cpp` is available
36+
but S3 support is disabled due to an insufficient curl version.

0 commit comments

Comments
 (0)