Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/ISSUE_TEMPLATE/bug_report.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ body:
options:
- Core
- ActiveMQ
- aws-emulator
- Azure
- Cassandra
- ChromaDB
Expand Down
1 change: 1 addition & 0 deletions .github/ISSUE_TEMPLATE/enhancement.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ body:
options:
- Core
- ActiveMQ
- aws-emulator
- Azure
- Cassandra
- ChromaDB
Expand Down
1 change: 1 addition & 0 deletions .github/ISSUE_TEMPLATE/feature.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ body:
options:
- Core
- ActiveMQ
- aws-emulator
- Azure
- Cassandra
- ChromaDB
Expand Down
1 change: 1 addition & 0 deletions .github/dependabot.yml
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,7 @@ updates:
- package-ecosystem: "gradle"
directories:
- "/modules/activemq"
- "/modules/aws-emulator"
- "/modules/azure"
- "/modules/clickhouse"
- "/modules/cockroachdb"
Expand Down
4 changes: 4 additions & 0 deletions .github/labeler.yml
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,10 @@
- changed-files:
- any-glob-to-any-file:
- modules/activemq/**/*
"modules/aws-emulator":
- changed-files:
- any-glob-to-any-file:
- modules/aws-emulator/**/*
"modules/azure":
- changed-files:
- any-glob-to-any-file:
Expand Down
36 changes: 36 additions & 0 deletions docs/modules/aws-emulator.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
# AWS Emulator

!!! note
This module is INCUBATING. While it is ready for use and operational in the current version of Testcontainers, it is possible that it may receive breaking changes in the future. See [our contributing guidelines](/contributing/#incubating-modules) for more information on our incubating modules policy.

Testcontainers module for [AWS Emulator](https://github.com/aws/aws-emulator).

## AwsEmulatorContainer's usage examples

You can start an AWS Emulator container instance from any Java application by using:

<!--codeinclude-->
[AWS Emulator container](../../modules/aws-emulator/src/test/java/org/testcontainers/awsemulator/AwsEmulatorContainerTest.java) inside_block:container
<!--/codeinclude-->

The container automatically configures the recommended 2 GiB memory limit, disables usage telemetry by default, waits for the HTTPS `/__admin/health` endpoint, and extracts the generated PKCS12 truststore (`getTrustStorePath()`) and SigV4 credentials (`getAccessKey()`, `getSecretKey()`).
## Adding this module to your project dependencies

Add the following dependency to your `pom.xml`/`build.gradle` file:

=== "Gradle"

```groovy
testImplementation "org.testcontainers:testcontainers-aws-emulator:{{latest_version}}"
```

=== "Maven"

```xml
<dependency>
<groupId>org.testcontainers</groupId>
<artifactId>testcontainers-aws-emulator</artifactId>
<version>{{latest_version}}</version>
<scope>test</scope>
</dependency>
```
1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -77,6 +77,7 @@ nav:
- modules/databases/trino.md
- modules/databases/yugabytedb.md
- modules/activemq.md
- modules/aws-emulator.md
- modules/azure.md
- modules/chromadb.md
- modules/consul.md
Expand Down
9 changes: 9 additions & 0 deletions modules/aws-emulator/build.gradle
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
description = "Testcontainers :: AWS Emulator"

dependencies {
api project(':testcontainers')

testImplementation 'software.amazon.awssdk:s3:2.31.1'
testImplementation 'software.amazon.awssdk:sts:2.31.1'
testImplementation 'software.amazon.awssdk:url-connection-client:2.31.1'
}
Loading
Loading