feat(guides): migrate all testcontainers.com guides#24505
Merged
aevesdocker merged 26 commits intodocker:mainfrom Mar 25, 2026
Merged
feat(guides): migrate all testcontainers.com guides#24505aevesdocker merged 26 commits intodocker:mainfrom
aevesdocker merged 26 commits intodocker:mainfrom
Conversation
Migrated from https://github.com/testcontainers/tc-guide-getting-started-with-testcontainers-for-nodejs Tests verified passing with @testcontainers/postgresql in container with Docker socket mounted. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Migrated from https://github.com/testcontainers/tc-guide-getting-started-with-testcontainers-for-dotnet Updated to Testcontainers.PostgreSql 4.6.0 and .NET 9.0. Tests verified passing in container with Docker socket mounted. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Migrated from https://github.com/testcontainers/tc-guide-testing-spring-boot-rest-api Tests verified passing with testcontainers-java 1.21.4 in container. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Migrated from https://github.com/testcontainers/tc-guide-testcontainers-lifecycle Covers JUnit 5 callbacks, extension annotations, and singleton containers pattern. Tests verified passing with testcontainers-java 1.21.4 in container. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Migrated from https://github.com/testcontainers/tc-guide-replace-h2-with-real-database-for-testing Covers JDBC URL approach, JUnit 5 extension, and JdbcTemplate testing. Tests verified passing with testcontainers-java 1.21.4 in container. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Migrated from https://github.com/testcontainers/tc-guide-configuration-of-services-running-in-container Covers copying files into containers and executing commands with execInContainer(). Tests verified passing with testcontainers-java 1.21.4 in container. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Migrated from https://github.com/testcontainers/tc-guide-testing-spring-boot-kafka-listener Tests verified passing with testcontainers-java 1.21.4 in container. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Migrated from https://github.com/testcontainers/tc-guide-testing-rest-api-integrations-using-mockserver Tests verified passing with testcontainers-java 1.21.4 in container. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Migrated from https://github.com/testcontainers/tc-guide-testing-aws-service-integrations-using-localstack Tests verified passing with testcontainers-java 1.21.4 in container. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Add links to new guides in testcontainers manuals page. Add Awaitility, datasource, Initializr, unmarshalling to vale accept list. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Migrated from https://github.com/testcontainers/tc-guide-testing-aspnet-core Tests verified passing (15/15) with Testcontainers.MsSql in container. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Migrated from https://github.com/testcontainers/tc-guide-testing-rest-api-integrations-using-wiremock Tests verified passing with testcontainers-java 1.21.4 in container. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Migrated from https://github.com/testcontainers/tc-guide-testing-rest-api-integrations-in-micronaut-apps-using-wiremock Tests verified passing with testcontainers-java 1.21.4 in container. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Migrated from https://github.com/testcontainers/tc-guide-securing-spring-boot-microservice-using-keycloak-and-testcontainers Tests verified passing with testcontainers-java 1.21.4 in container. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Migrated from https://github.com/testcontainers/tc-guide-testcontainers-in-quarkus-applications Tests verified passing with testcontainers-java 1.21.4 in container. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Migrated from https://github.com/testcontainers/tc-guide-testing-micronaut-kafka-listener Tests verified passing with testcontainers-java 1.21.4 in container. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Migrated from https://github.com/testcontainers/tc-guide-working-with-jooq-flyway-using-testcontainers Tests verified passing with testcontainers-java 1.21.4 in container. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
✅ Deploy Preview for docsdocker ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
aevesdocker
approved these changes
Mar 25, 2026
Contributor
aevesdocker
left a comment
aevesdocker
left a comment
There was a problem hiding this comment.
Amazing! Thank you @mdelapenya
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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-migratorskill 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:Related issues or tickets
Supersedes #24450 (expanded from 2 guides to all 19)
Reviews