docker-docs/content/guides/testcontainers-java-service-configuration/_index.md at bot/sync-cli-docs

mirror of https://github.com/docker/docs.git synced 2026-03-28 23:08:49 +07:00

Files

Manuel de la Peña b951e92f57 feat(guides): migrate all testcontainers.com guides (#24505 )

## Description

Migrate 17 Testcontainers guides from testcontainers.com into the Docker
docs site, covering Java (14 guides), .NET (2 guides), and Node.js (1
guide). This follows up on PR #24450 which added the initial Go and
Python guides.

Each guide is converted from AsciiDoc to Hugo Markdown, split into
multi-chapter stepper navigation, updated to the latest Testcontainers
API, and verified with passing tests running in containers.

Java guides use testcontainers-java 2.0.4 with the new 2.x Maven
coordinates and package names (e.g., `testcontainers-postgresql`,
`org.testcontainers.postgresql.PostgreSQLContainer`). The Quarkus guide
uses Quarkus 3.22.3 with TC 1.x managed by the Quarkus BOM, since no
released Quarkus version ships TC 2.x yet.

## How to test

All code snippets have been verified by running each guide's source
repository tests inside Docker containers with the Docker socket
mounted.

To re-run the verification, use the `/testcontainers-guides-migrator`
skill included in this PR
(`.claude/skills/testcontainers-guides-migrator/SKILL.md`). The skill's
Step 6 documents the exact container commands and macOS Docker Desktop
workarounds (host override, docker-java API version, etc.) needed to run
each language's tests:

```
/testcontainers-guides-migrator I want you to verify all the guides in this branch.
Do a full review, verifying that all code snippets compile, the code is executable,
and ALL the tests pass. Run them as docker containers, never locally.
```

## Related issues or tickets

Supersedes #24450 (expanded from 2 guides to all 19)

## Reviews

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-03-25 10:03:26 +00:00

1.2 KiB

Raw Permalink Blame History

title, linkTitle, description, keywords, summary, toc_min, toc_max, tags, languages, params

title

linkTitle

description

keywords

summary

toc_min

toc_max

tags

languages

params

Configuration of services running in a container

Service configuration (Java)

Learn how to configure services running in Testcontainers by copying files and executing commands inside containers.

testcontainers, java, testing, postgresql, localstack, container configuration

Learn how to initialize and configure Docker containers for testing by copying files into containers and executing commands inside them.

testing-with-docker

java

time
15 minutes

In this guide, you will learn how to:

Initialize containers by copying files into them
Run commands inside running containers using execInContainer()
Set up a PostgreSQL database with SQL scripts
Create AWS S3 buckets in LocalStack containers

Prerequisites

Java 17+
Your preferred IDE
A Docker environment supported by Testcontainers

Note

If you're new to Testcontainers, visit the Testcontainers overview to learn more about Testcontainers and the benefits of using it.

1.2 KiB Raw Permalink Blame History

Prerequisites

1.2 KiB

Raw Permalink Blame History