docker-docs/content/guides/testcontainers-java-keycloak-spring-boot/_index.md at bot/sync-cli-docs

mirror of https://github.com/docker/docs.git synced 2026-03-28 06:49:00 +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.3 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

Securing Spring Boot microservice using Keycloak and Testcontainers

Keycloak with Spring Boot

Learn how to secure a Spring Boot microservice using Keycloak and test it with the Testcontainers Keycloak module.

testcontainers, java, spring boot, testing, keycloak, security, oauth2, jwt

Learn how to create an OAuth 2.0 Resource Server using Spring Boot, secure API endpoints with Keycloak, and test the application using the Testcontainers Keycloak module.

testing-with-docker

java

time
30 minutes

In this guide, you'll learn how to:

Create an OAuth 2.0 Resource Server using Spring Boot
Secure API endpoints using Keycloak
Test the APIs using the Testcontainers Keycloak module
Run the application locally using the Testcontainers Keycloak module

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

Prerequisites

1.3 KiB

Raw Permalink Blame History