Gradle plugins for running AWS Emulator, provisioning AWS resources, and configuring JVM tests and local applications to use the emulator.

build.gradle.kts
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:

Terminal
./gradlew -p examples/basic integrationTest --configuration-cache
01
Provision ResourcesCreate S3 buckets and SQS queues in a fresh emulator.
02
Send SDK RequestsRun signed AWS SDK requests against your local resources.
03
Remove The ContainerRemove the managed container when the build finishes.

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

Integration Guides

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.