docker-docs/content/guides/testcontainers-java-spring-boot-rest-api/_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.1 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

Testing a Spring Boot REST API with Testcontainers

Spring Boot REST API

Learn how to test a Spring Boot REST API using Testcontainers with PostgreSQL and REST Assured.

testcontainers, java, spring boot, testing, postgresql, rest api, rest assured, jpa

Learn how to create a Spring Boot REST API with Spring Data JPA and PostgreSQL, then test it using Testcontainers and REST Assured.

testing-with-docker

java

time
25 minutes

In this guide, you will learn how to:

Create a Spring Boot application with a REST API endpoint
Use Spring Data JPA with PostgreSQL to store and retrieve data
Test the REST API using Testcontainers and REST Assured

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.1 KiB Raw Permalink Blame History

Prerequisites

1.1 KiB

Raw Permalink Blame History