| Key | Value |
|---|---|
| Services | CloudFormation, SNS, SQS, SES |
| Integrations | AWS SDK, Docker Compose |
| Categories | Messaging; Notifications |
A Spring Boot application demonstrating AWS messaging services with LocalStack. The sample provisions CloudFormation infrastructure for SNS/SQS subscriptions, processes messages from SQS using the AWS Java SDK, and sends email notifications via SES. A MailHog SMTP server runs alongside LocalStack for local email testing.
- A valid LocalStack for AWS license. Your license provides a
LOCALSTACK_AUTH_TOKENto activate LocalStack. - Docker and Docker Compose
awslocalCLI- Java 11+ and Maven 3+
make checkmake installThis will install the Maven dependencies for the project and build the project.
export LOCALSTACK_AUTH_TOKEN=<your-auth-token>
make startThis starts LocalStack and a MailHog SMTP server via Docker Compose. Access the MailHog UI at http://localhost:8025/.
make deployDeploys the CloudFormation stack with SNS, SQS, and SES infrastructure.
Start the Spring Boot application (requires dummy AWS credentials as environment variables):
AWS_ACCESS_KEY_ID=test AWS_SECRET_ACCESS_KEY=test mvn spring-boot:runRun everything via make run or follow the steps below.
Verify the sender email address configured in the app:
awslocal ses verify-email-identity --email-address no-reply@localstack.cloudSend a message to the topic:
awslocal sns publish --topic arn:aws:sns:us-east-1:000000000000:email-notifications --message '{"subject":"hello", "address": "alice@example.com", "body": "hello world"}'Run the /process endpoint to send the queued notifications as emails:
curl -s localhost:8080/processVerify that the email has been sent:
- either check MailHog via the UI http://localhost:8025/
- or query the LocalStack internal SES endpoint:
curl -s localhost:4566/_localstack/ses | jq .
This code is available under the Apache 2.0 license.