[Feature]: Add support for AWS Emulator
Maintainer antworten meist innerhalb von 1 Tag
Dieses Issue hat noch niemand übernommen.
Bewertung
- Schwierigkeit
- 5/5
- Geschätzter Aufwand
- Über eine Woche
- Anfängerfreundlichkeit
- 22/100
Rechercherichtung
Start with the existing LocalStack module, which the issue names as the model for a new AwsEmulatorContainer module, and with the GenericContainer usage it replaces. Decide how the official AWS Emulator Dockerfile and image are consumed, and how the /__admin/health check, endpoint URL, credentials, truststore helper and default 2 GiB memory limit are exposed. Done means a module with tests that start the container, pass the health check and point an AWS SDK client at it. The issue has no assignee and needs maintainer design input first.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
Module
None
Problem
AWS Emulator (released 11 Nov 2026) is an official, free local emulator of AWS APIs. There is currently no Testcontainers module for it. Users must manually build a Docker image from AWS’s Dockerfile, write a custom GenericContainer, and handle the self-signed certificate/truststore required by the AWS SDK for Java. This creates friction for Java teams that already use Testcontainers for integration tests.
Solution
Add a first-class AwsEmulatorContainer module (similar to the existing LocalStack module) that:
- Provides a ready-to-use container (or easy image builder based on the official Dockerfile)
- Includes a health check on /__admin/health
- Exposes helpers for the endpoint URL, credentials, and Java truststore configuration
- Defaults to telemetry off and the recommended 2 GiB memory limit
Links::
GitHub: [github.com/aws/aws-emulator](https://github.com/aws/aws-emulator)
Docs: [docs.aws.amazon.com/emulator](https://docs.aws.amazon.com/emulator/)
Docker getting started: [docs.aws.amazon.com/emulator/latest/userguide/getting-started-docker.html](https://docs.aws.amazon.com/emulator/latest/userguide/getting-started-docker.html)
Announcement: [aws.amazon.com/blogs/aws/test-your-applications-against-aws-locally-with-aws-emulator](https://aws.amazon.com/blogs/aws/test-your-applications-against-aws-locally-with-aws-emulator/)
Benefit
Java teams can start an isolated AWS Emulator instance with a few lines of code, point the AWS SDK at it, and get clean per-test or per-class lifecycle management. This lowers the barrier to adopting the official emulator for local and CI testing, especially as an alternative to LocalStack.
Alternatives
- Continue writing custom GenericContainer subclasses (current state).
- Use the native Linux package + process management outside Testcontainers.
- Use LocalStack (requires a token for many services and is not the official AWS emulator).
- Wait for an embedded mode for Java (currently only available for Rust).
Would you like to help contributing this feature?
No
- Vorherrschende Sprache
- Java
- Sterne
- 8.8k
- Forks
- 2k
- Ø Merge
- 5 T. 21 Std.
- Gemergte PRs (30 T.)
- 15
Entwicklungsumgebung
Startet den Dev-Container des Projekts im Browser, mit Ihrem eigenen GitHub-Konto.
- Enthält ein Dockerfile oder eine Docker-Compose-Datei
- Hat eine Pull-Request-Vorlage
- Beitragsleitfaden lesen
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus testcontainers/testcontainers-java
-
[Bug]: withStartupTimeout() changes the startup timeout of all containers that use the default wait strategyEvtl. vergeben @aymenjamaaoui hat das vor 1 Tag übernommen. Offentype/bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 64/100
testcontainers/testcontainers-java#12171 ·
Maintainer antworten meist innerhalb von 1 Tag
-
[Enhancement]: Document why singleton containers are required under Spring's test context cachingEvtl. vergeben @zakaullah075 hat das vor 95 Tagen übernommen. Offentype/enhancement
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 85/100
testcontainers/testcontainers-java#11967 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag
-
[Bug]: Cannot reuse Selenium BrowserWebDriverContainers under LinuxEvtl. vergeben @kdelay hat das vor 116 Tagen übernommen. Offentype/bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
testcontainers/testcontainers-java#11941 ·
Maintainer antworten meist innerhalb von 1 Tag
-
[Bug]: DockerDesktopClientProviderStrategy is always applicableEvtl. vergeben @seonwooj0810 hat das vor 165 Tagen übernommen. Offentype/bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 74/100
testcontainers/testcontainers-java#11829 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag
-
[Enhancement]: cleanup document after removing junit4 supportEvtl. vergeben @SJvaca30 hat das vor 173 Tagen übernommen. Offentype/enhancement
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 65/100
testcontainers/testcontainers-java#11578 ·
Maintainer antworten meist innerhalb von 1 Tag
Alle Issues in testcontainers/testcontainers-java
Ähnliche Issues
-
bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 85/100
yegor256/jping#122 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 75/100
SAP/ai-sdk-java#1206 ·
Maintainer antworten meist innerhalb von 1 Tag
-
enhancement good first issue insight-module
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 86/100
sdlc-pro/spring-lens#606 ·
Maintainer antworten meist innerhalb von 1 Tag
-
bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 76/100
apache/cloudstack#14719 ·
Maintainer antworten meist innerhalb von 1 Tag
-
enhancement
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 75/100
apache/maven-surefire#3605 ·
Maintainer antworten meist innerhalb von 1 Tag