This is an automated email from the ASF dual-hosted git repository.
zhfeng pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel-quarkus.git
The following commit(s) were added to refs/heads/main by this push:
new d85861f Fix #3095 improve the aws2-s3 doc to explain chunk_signature
in multi part upload (#3237)
d85861f is described below
commit d85861f65f5751901de580416c466e6994366f6a
Author: Amos Feng <[email protected]>
AuthorDate: Thu Oct 28 08:52:25 2021 +0800
Fix #3095 improve the aws2-s3 doc to explain chunk_signature in multi part
upload (#3237)
---
.../ROOT/pages/reference/extensions/aws2-s3.adoc | 33 ++++++++++++++++++++++
.../runtime/src/main/doc/configuration.adoc | 33 ++++++++++++++++++++++
2 files changed, 66 insertions(+)
diff --git a/docs/modules/ROOT/pages/reference/extensions/aws2-s3.adoc
b/docs/modules/ROOT/pages/reference/extensions/aws2-s3.adoc
index 792db17..9863b00 100644
--- a/docs/modules/ROOT/pages/reference/extensions/aws2-s3.adoc
+++ b/docs/modules/ROOT/pages/reference/extensions/aws2-s3.adoc
@@ -77,3 +77,36 @@ class UnremovableS3Client {
}
----
+=== Multipart Upload
+When you use multipart uploads with a file size larger than
xref:{cq-camel-components}::aws2-s3-component.adoc#_component_option_partSize[partSize]
(the default is 25M, and the low limit is 5M according to
https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html).
+The getObject operation after uploading returns a result which contains
```chunk_signature```.
+
+If you want to get rid of these signatures, you have to create your own
instance of ```S3Client``` just like
+
+[source,java]
+----
+import javax.enterprise.inject.Produces;
+
+import software.amazon.awssdk.services.s3.S3Client;
+import software.amazon.awssdk.services.s3.S3ClientBuilder;
+import software.amazon.awssdk.services.s3.S3Configuration;
+
+@Produces
+public S3Client getClient() {
+ S3ClientBuilder builder = S3Client.builder();
+ S3Configuration.Builder s3ConfigBuilder = S3Configuration.builder()
+ .checksumValidationEnabled(false)
+ .chunkedEncodingEnabled(false);
+ builder.serviceConfiguration(s3ConfigBuilder.build());
+
+ return builder.build();
+}
+----
+
+or if you use the Quarkus Amazon S3 Client extension, you need to set
+[source,properties]
+----
+quarkus.s3.chunked-encoding=false
+quarkus.s3.checksum-validation=false
+----
+
diff --git a/extensions/aws2-s3/runtime/src/main/doc/configuration.adoc
b/extensions/aws2-s3/runtime/src/main/doc/configuration.adoc
index f8748fc..e1f55aa 100644
--- a/extensions/aws2-s3/runtime/src/main/doc/configuration.adoc
+++ b/extensions/aws2-s3/runtime/src/main/doc/configuration.adoc
@@ -27,3 +27,36 @@ class UnremovableS3Client {
S3Client s3Client;
}
----
+
+=== Multipart Upload
+When you use multipart uploads with a file size larger than
xref:{cq-camel-components}::aws2-s3-component.adoc#_component_option_partSize[partSize]
(the default is 25M, and the low limit is 5M according to
https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html).
+The getObject operation after uploading returns a result which contains
```chunk_signature```.
+
+If you want to get rid of these signatures, you have to create your own
instance of ```S3Client``` just like
+
+[source,java]
+----
+import javax.enterprise.inject.Produces;
+
+import software.amazon.awssdk.services.s3.S3Client;
+import software.amazon.awssdk.services.s3.S3ClientBuilder;
+import software.amazon.awssdk.services.s3.S3Configuration;
+
+@Produces
+public S3Client getClient() {
+ S3ClientBuilder builder = S3Client.builder();
+ S3Configuration.Builder s3ConfigBuilder = S3Configuration.builder()
+ .checksumValidationEnabled(false)
+ .chunkedEncodingEnabled(false);
+ builder.serviceConfiguration(s3ConfigBuilder.build());
+
+ return builder.build();
+}
+----
+
+or if you use the Quarkus Amazon S3 Client extension, you need to set
+[source,properties]
+----
+quarkus.s3.chunked-encoding=false
+quarkus.s3.checksum-validation=false
+----
