Gradle plugins for running AWS Emulator, provisioning AWS resources, and configuring JVM tests and local applications to use the emulator.
plugins {
java
id("io.github.gregwhitaker.aws-emulator") version "0.3.0"
}
awsEmulator {
useWith(tasks.named<Test>("integrationTest"))
}
Run The Example
From this repository’s root, run the included example:
./gradlew -p examples/basic integrationTest --configuration-cache
The first run builds the emulator image; later runs reuse it. Run the command again to check configuration-cache reuse. Follow the getting started guide to add the plugin to your own application.
Run tests against a fresh emulator or keep one running for local development.
AWS Resources
Create and configure resources with service-specific Gradle tasks.
Integration Guides
Run and debug Spring Boot with automatic resource setup.
Configure AWS clients, SQS listeners, and configuration imports.
Run and test Micronaut with injected AWS SDK clients.
Run and test Ktor routes against provisioned AWS resources.
Keep your application’s AWS SDK and test dependencies, and see SDK connection setup for endpoints and TLS. Applying the plugin alone does not start Docker; tasks opt in explicitly.
Requirements
Use Java 17+, Gradle 8.14+, and a local Docker engine running Linux containers. The first run builds an image from AWS’s pinned 1.0.385 package. Linux AMD64 and ARM64 are supported; subsequent runs reuse the image.
Docker integration is verified on Linux AMD64 and ARM64. Windows runs the Docker-free verification suite; Docker integration on Windows has not been verified.
For ports, images, regions, and timeouts, see configuration. See AWS Emulator for the upstream project, or troubleshooting if something isn’t working.