Skip to content

Releases: awspring/spring-cloud-aws

3.0.0-RC1

30 Jan 08:18
@maciejwalkowiak maciejwalkowiak
v3.0.0-RC1
91d8c7b
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
3.0.0-RC1

Spring Cloud AWS 3.0 RC1 brings all the features that are planned for the 3.0 release.

📗 https://docs.awspring.io/spring-cloud-aws/docs/3.0.0-RC1/reference/html/index.html

The most notable features added in RC1 are:

SqsTemplate

SqsTemplate is an higher level abstraction on the top of SqsAsyncClient for sending and receiving messages imperatively:

SendResult<String> result = template.send(to -> to.queue("myQueue")
    .payload("myPayload")
    .header("myHeaderName", "myHeaderValue")
    .headers(Map.of("myOtherHeaderName", "myOtherHeaderValue"))
    .delaySeconds(10)
);

Go to reference documentation for more details.

S3 URL signing

S3Template integrates now with S3Presigner for creating signed URLs

URL signedGetUrl = s3Template.createSignedGetUrl("bucket_name", "file.txt", Duration.ofMinutes(5));

Go to reference documentation for more details.

Secrets Manager

Secrets Manager integration now supports binary secrets and allows setting properties prefix to avoid collision with other property sources.

spring.config.import=optional:aws-secretsmanager:/secrets/database-secrets?prefix=db.

Go to reference documentation for more details.

What's Changed

SQS

S3

DynamoDB

Secrets Manager

Core

Other

Feedback

We are aware that 3.0 release breaks existing code but this was the only sensible way we could evolve the framework and meet the demand in constrained time we have. We are very open for your feedback and appreciate any shoutout on social media and Github ⭐️.

This release would not happen without our wonderful community. Big thanks for your bug reports, ideas and pull requests!

New Contributors

Full Changelog: v3.0.0-M3...v3.0.0-RC1

Contributors

klopfdreh, maciejwalkowiak, and 11 other contributors
Assets 2

2.4.3

29 Jan 08:05
@maciejwalkowiak maciejwalkowiak
v2.4.3
9930ac4
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
2.4.3

What's Changed

Big thanks to all contributors!

📗 https://docs.awspring.io/spring-cloud-aws/docs/2.4.3/reference/html/index.html

New Contributors

Full Changelog: v2.4.2...v2.4.3

Contributors

maciejwalkowiak, chrylis, and 2 other contributors
Assets 2

v3.0.0-M3

23 Oct 08:19
@maciejwalkowiak maciejwalkowiak
v3.0.0-M3
89c48d8
Compare
Choose a tag to compare
v3.0.0-M3

Spring Cloud AWS 3.0.0 M3 is the first release compatible with Spring Boot 3.0. At the same time, there is no compatibility anymore with Spring Boot 2.x.

The most notable changes:

📗 https://docs.awspring.io/spring-cloud-aws/docs/3.0.0-M3/reference/html/index.html

Full Changelog: v3.0.0-M2...v3.0.0-M3

Big thanks to all contributors!

Other changes

New Contributors

Full Changelog: v3.0.0-M2...v3.0.0-M3

Contributors

sivaprasadreddy, maciejwalkowiak, and 3 other contributors
Assets 2

3.0.0-M2

02 Sep 19:23
@maciejwalkowiak maciejwalkowiak
v3.0.0-M2
0c1fbff
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
3.0.0-M2

M2 is the next milestone in our journey to rewrite Spring Cloud AWS to use AWS SDK v2.

The most important changes since M1:

SQS

Completely rewritten SQS integration 🔥 #374:

  • auto-configuration for SqsAsyncClient
  • support for @SqsListener
  • ability to create SQS listener with simple lambda without annotation
  • support for batch listeners
  • support for FIFO queues
  • @SqsTest annotation for slice testing of SQS listeners

SqsTemplate for sending messages will be added in M3.

DynamoDB

New integration #339 🚀

CloudWatch

  • auto-configuration for micrometer-registry-cloudwatch2 #237

S3

Improvement to S3Resource:

  • Add Ability to get metadata via S3Resource #451

Improvements to cross-region S3 client:

  • Read bucket region from redirect header #453
  • Use status code instead of message to detect region change #459

📗 https://docs.awspring.io/spring-cloud-aws/docs/3.0.0-M2/reference/html/index.html

Full Changelog: v3.0.0-M1...v3.0.0-M2

Big thanks to all contributors!

What's Changed

New Contributors

Full Changelog: v3.0.0-M1...v3.0.0-M2

Contributors

maciejwalkowiak, eddumelendez, and 5 other contributors
Assets 2

2.4.2

24 Jul 10:20
@maciejwalkowiak maciejwalkowiak
v2.4.2
1adc1fb
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
2.4.2

Big thanks to all contributors!

📗 https://docs.awspring.io/spring-cloud-aws/docs/2.4.2/reference/html/index.html

Contributors

maciejwalkowiak and boolivar
Assets 2

3.0.0-M1

16 Jun 20:20
@maciejwalkowiak maciejwalkowiak
v3.0.0-M1
8b9ac3d
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
3.0.0-M1 Pre-release
Pre-release

Spring Cloud AWS 3.0 is a rewrite of the project using AWS SDK v2 for Java. Since this has required a major refactoring, we took it as an opportunity to revisit all the assumptions and integrations modules. As a result, we've produced a library that is lightweight, flexible, causes less headache, provides simple to use abstractions and also works much better with Kotlin.

Only a subset of integrations have been migrated in M1:

  • S3
  • SES
  • SNS
  • Secrets Manager
  • Parameter Store

We strongly recommend checking out completely rewritten reference documentation for a deep dive into each integration including code samples:

📗 https://docs.awspring.io/spring-cloud-aws/docs/3.0.0-M1/reference/html/index.html

Core

Dropped support for XML configuration and @EnableXXX annotations. Spring Cloud AWS can be used either with Spring Boot auto-configurations, or beans have to be created manually.

New properties prefix

All Spring Cloud AWS related properties have moved from cloud.aws to spring.cloud.aws prefix.

Endpoint configuration

Endpoint used by all integrations can be configured through a property:

spring.cloud.aws.endpoint=http://localhost:4566

Endpoint used by an individual integration can be also defined per integration:

spring.cloud.aws.s3.endpoint=http://localhost:4566

This is especially useful when Localstack is used instead of real AWS.

Credentials and region configuration

Credentials and region are resolved through the new interfaces from AWS SDK v2 for Java: software.amazon.awssdk.auth.credentials.AwsCredentialsProvider and software.amazon.awssdk.regions.providers.AwsRegionProvider.

It is possible to configure both through properties. In special cases, users can provide custom implementations of these interfaces to opt-out from ones that are auto-configured. Check the reference documentation for more details.

Nullability annotations

Every class field, method parameter and return value is annotated with @NonNull or @Nullable annotation, making it easier to use with null safe languages like Kotlin.

AWS Client Builder Configurers

AwsClientBuilderConfigurer simplifies applying same configuration for endpoint, region and credentials to user defined AWS clients beans:

import io.awspring.cloud.autoconfigure.core.AwsClientBuilderConfigurer;
...

@Bean
TextractClient textractClient(AwsClientBuilderConfigurer configurer) {
    return configurer.configure(TextractClient.builder()).build();
}

AWS Client Customizers

AwsClientCustomizer simplifies customizing AWS clients created by integrations without overwriting complete beans:

import io.awspring.cloud.autoconfigure.core.AwsClientCustomizer;
...

@Component
class S3AwsClientClientConfigurer implements AwsClientCustomizer<S3ClientBuilder> {
	@Override
	public ClientOverrideConfiguration overrideConfiguration() {
		...
	}

	@Override
	public SdkHttpClient httpClient() {
		...
	}
}

Note that AwsClientCustomizer is a parameterized type, and the type determines to which client customization gets applied.

S3

  • all S3 related classes have moved to io.awspring.cloud.s3 package.
  • SimpleStorageResource has been renamed to S3Resource
  • S3 client can be configured with spring.cloud.aws.s3 properties
  • dropped support for ResourcePatternResolver.

Cross-Region S3 client

S3Client implementation provided by Spring Cloud AWS can access buckets in any region. When accessed bucket is in other region than the one provided for S3 auto-configuration, the CrossRegionS3Clients handles redirects sent by S3 transparently.

Output Streams

S3 integration comes with three implementations of the OutputStream used under the hood by S3Resource for writing data to S3.

  • InMemoryBufferingS3OutputStream (default) - buffers content of the uploaded file in memory and uploads to S3 using multipart upload
  • DiskBufferingS3OutputStream - saves uploaded file to temporary folder on disk and uploads to S3 in single chunk
  • TransferManagerS3OutputStream - uses experimental Transfer Manager to upload files to S3. Requires adding a dependency to software.amazon.awssdk:s3-transfer-manager

To use different output stream than one provided by auto-configuration, define a bean of type S3OutputStreamProvider - either with custom implementation or one of: DiskBufferingS3OutputStreamProvider, TransferManagerS3OutputStreamProvider, InMemoryBufferingS3OutputStreamProvider.

S3Template

S3Template is a new class that simplifies performing common operations on S3 buckets and S3 objects. It also supports reading and persisting Java objects to S3. Spring Cloud AWS provides Jackson based Jackson2JsonS3ObjectConverter which serialized persisted objects into JSON files. Custom object converted can be provided by defining a bean of type S3ObjectConverter.

Object Metadata Support

Both S3Resource and S3Template support setting object metadata through a builder-like object ObjectMetadata.

Content-Type Resolution

If uploaded file to S3 does not have contentType metadata property set, both S3Resource and S3Template will resolve content type through S3ObjectContentTypeResolver. The default implementation resolves content type by file extension. The framework provides a comprehensive support for 817 file extensions.

SES

SES integration does not bring any new features in comparison to what's offered in version 2.4.1.
SES integration can be configured using properties with spring.cloud.aws.ses prefix.

SNS

On top of what's been offered in 2.4.1, SNS integration provides a simple interfaces for sending notifications with custom payload and headers using SnsOperations#sendNotification method and SnsNotification object.

Because SNS Message Manager has not been migrated to AWS SDK v2, we had to drop support for message signature validation. We hope AWS finishes migration before Spring Cloud AWS reaches 3.0 GA.

SNS integration can be configured using properties with spring.cloud.aws.sns prefix.

Secrets Manager

  • dropped support for loading properties from Secrets Manager using Spring Cloud Bootstrap - only loading through spring.config.import=aws-secretsmanager is now possible
  • added support for loading both secrets containing JSON and plain text
  • simplified using custom SecretsManagerClient

Secrets Manager integration can be configured using properties with spring.cloud.aws.secretsmanager prefix.

Parameter Store

  • dropped support for loading properties from Parameter Store using Spring Cloud Bootstrap - only loading through spring.config.import=aws-parameterstore is now possible
  • simplified using custom SsmClient

Parameter Store integration can be configured using properties with spring.cloud.aws.parameterstore prefix.

Reference Documentation

Reference documentation has been rewritten with simplicity and "straight to the point" attitude.

📗 https://docs.awspring.io/spring-cloud-aws/docs/3.0.0-M1/reference/html/index.html

Feedback

We are aware that this release breaks existing code but this was the only sensible way we could evolve the framework and meet the demand in constrained time we have. We are very open for your feedback and appreciate any shoutout on social media and Github ⭐️.

This release would not happen without our wonderful community. Big thanks for your bug reports, ideas and pull requests!

New Contributors

Full Changelog: v2.4.1...v3.0.0-M1

Contributors

zeldigas, willome, and 5 other contributors
Assets 2
0 Join discussion

2.3.5

03 May 10:36
@maciejwalkowiak maciejwalkowiak
v2.3.5
fe32645
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
2.3.5

This release backports a fix from 2.4.1 to 2.3.x for Spring Boot 2.4 & 2.5 compatibility

  • Relax prefix validation rules in Parameter Store and Secrets Manager #304 @MatejNedic

📗 https://docs.awspring.io/spring-cloud-aws/docs/2.3.5/reference/html/index.html

Contributors

MatejNedic
Assets 2

2.4.1

10 Apr 20:25
@maciejwalkowiak maciejwalkowiak
v2.4.1
5f07da7
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
2.4.1

Big thanks to all contributors!

📗 https://docs.awspring.io/spring-cloud-aws/docs/2.4.1/reference/html/index.html

Contributors

maciejwalkowiak, rmpestano, and MatejNedic
Assets 2

2.4.0

16 Feb 10:57
@MatejNedic MatejNedic
v2.4.0
5727b0b
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
2.4.0

This version brings compatibility with Spring Boot 2.6 and few enhancements:

SQS

Add @SqsTest annotation to simplify SQS integration testing (#235) @maciejwalkowiak
Complete example on how to test SQS listener with @SqsTest, Localstack and Testcontainers.

SNS

Verify SNS messages in HTTP subscription mode (#240) @MatejNedic @WtfJoke @maciejwalkowiak

Core

Upgrade to Spring Cloud Build commons to 3.1.0 (#211) @spencergibb

Big thanks to all contributors!

📗 https://docs.awspring.io/spring-cloud-aws/docs/2.4.0/reference/html/index.html

Contributors

spencergibb, maciejwalkowiak, and 2 other contributors
Assets 2

2.3.4

11 Feb 18:19
@maciejwalkowiak maciejwalkowiak
v2.3.4
218a4d1
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
2.3.4

This version brings several bug fixes and small improvements:

Parameter Store & Secrets Manager

SQS

Core

Big thanks to all contributors!

📗 https://docs.awspring.io/spring-cloud-aws/docs/2.3.4/reference/html/index.html

Contributors

maciejwalkowiak, fernandomoraes, and 3 other contributors
Assets 2