docker-docs/content/guides/testcontainers-java-getting-started/_index.md at main

mirror of https://github.com/docker/docs.git synced 2026-03-27 22:38:54 +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

Getting started with Testcontainers for Java

Testcontainers for Java

Learn how to use Testcontainers for Java to test a customer service with a real PostgreSQL database.

testcontainers, java, testing, postgresql, integration testing, junit, maven

Learn how to create a Java application and test database interactions using Testcontainers for Java with a real PostgreSQL instance.

testing-with-docker

java

time
20 minutes

In this guide, you will learn how to:

Create a Java project with Maven
Implement a CustomerService that manages customer records in PostgreSQL
Write integration tests using Testcontainers with a real Postgres database
Run the tests and verify everything works

Prerequisites

Java 17+
Maven or Gradle
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