This is an automated email from the ASF dual-hosted git repository. acosentino pushed a commit to branch 2345-6 in repository https://gitbox.apache.org/repos/asf/camel-kamelets.git
commit 883295b77b6cdcf35dc5aa1745ddd56cb705a31c Author: Andrea Cosentino <anco...@gmail.com> AuthorDate: Wed Jan 15 15:57:11 2025 +0100 Kamelets Catalog - Make the description a one liner - AWS S3 Sink Signed-off-by: Andrea Cosentino <anco...@gmail.com> --- .../ROOT/partials/aws-s3-sink-description.adoc | 26 ++++++++++++++++++++++ kamelets/aws-s3-sink.kamelet.yaml | 11 +-------- .../resources/kamelets/aws-s3-sink.kamelet.yaml | 11 +-------- 3 files changed, 28 insertions(+), 20 deletions(-) diff --git a/docs/modules/ROOT/partials/aws-s3-sink-description.adoc b/docs/modules/ROOT/partials/aws-s3-sink-description.adoc new file mode 100644 index 00000000..dee86f3d --- /dev/null +++ b/docs/modules/ROOT/partials/aws-s3-sink-description.adoc @@ -0,0 +1,26 @@ +== AWS S3 Sink Kamelet Description + +=== Authentication methods + +In this Kamelet you have the possibility of avoiding the usage of explicit static credentials by specifying the useDefaultCredentialsProvider option and set it to true. + +The order of evaluation for Default Credentials Provider is the following: + + - Java system properties - `aws.accessKeyId` and `aws.secretKey`. + - Environment variables - `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY`. + - Web Identity Token from AWS STS. + - The shared credentials and config files. + - Amazon ECS container credentials - loaded from the Amazon ECS if the environment variable `AWS_CONTAINER_CREDENTIALS_RELATIVE_URI` is set. + - Amazon EC2 Instance profile credentials. + +You have also the possibility of using Profile Credentials Provider, by specifying the useProfileCredentialsProvider option to true and profileCredentialsName to the profile name. + +Only one of access key/secret key or default credentials provider could be used + +For more information about this you can look at https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/credentials.html[AWS credentials documentation] + +=== Optional Headers + +In the header, you can optionally set the `file` / `ce-file` property to specify the name of the file to upload. + +If you do not set the property in the header, the Kamelet uses the exchange ID for the file name. diff --git a/kamelets/aws-s3-sink.kamelet.yaml b/kamelets/aws-s3-sink.kamelet.yaml index fd0a2a1d..d73e2f6e 100644 --- a/kamelets/aws-s3-sink.kamelet.yaml +++ b/kamelets/aws-s3-sink.kamelet.yaml @@ -31,16 +31,7 @@ metadata: spec: definition: title: "AWS S3 Sink" - description: |- - Upload data to an Amazon S3 Bucket. - - The basic authentication method for the S3 service is to specify an access key and a secret key. These parameters are optional because the Kamelet provides a default credentials provider. - - If you use the default credentials provider, the S3 client loads the credentials through this provider and doesn't use the basic authentication method. - - In the header, you can optionally set the `file` / `ce-partition` property to specify the name of the file to upload. - - If you do not set the property in the header, the Kamelet uses the exchange ID for the file name. + description: Upload data to an Amazon S3 Bucket. required: - bucketNameOrArn - region diff --git a/library/camel-kamelets/src/main/resources/kamelets/aws-s3-sink.kamelet.yaml b/library/camel-kamelets/src/main/resources/kamelets/aws-s3-sink.kamelet.yaml index fd0a2a1d..d73e2f6e 100644 --- a/library/camel-kamelets/src/main/resources/kamelets/aws-s3-sink.kamelet.yaml +++ b/library/camel-kamelets/src/main/resources/kamelets/aws-s3-sink.kamelet.yaml @@ -31,16 +31,7 @@ metadata: spec: definition: title: "AWS S3 Sink" - description: |- - Upload data to an Amazon S3 Bucket. - - The basic authentication method for the S3 service is to specify an access key and a secret key. These parameters are optional because the Kamelet provides a default credentials provider. - - If you use the default credentials provider, the S3 client loads the credentials through this provider and doesn't use the basic authentication method. - - In the header, you can optionally set the `file` / `ce-partition` property to specify the name of the file to upload. - - If you do not set the property in the header, the Kamelet uses the exchange ID for the file name. + description: Upload data to an Amazon S3 Bucket. required: - bucketNameOrArn - region