Skip to content

Perform failure analysis when Testcontainers cannot find a valid Docker environment #47797

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Perform failure analysis when Testcontainers cannot find a valid Docker environment #47797

wants to merge 1 commit into from
+149 −0

Conversation

@nosan
Copy link
Contributor

@nosan nosan commented Oct 24, 2025

See #45281


***************************
APPLICATION FAILED TO START
***************************

Description:

Could not find a valid Docker environment for Testcontainers.

Action:

    - Ensure a Docker-compatible container engine is installed and running.
    - If running Testcontainers in CI, ensure the runner has access to the daemon, typically by using a mounted socket or a Docker-in-Docker setup.
    - Review the Testcontainers documentation for troubleshooting and advanced configuration options.

@nosan
Add DockerEnvironmentNotFoundFailureAnalyzer
181fdda 
Introduce a FailureAnalyzer to provide actionable guidance
when Testcontainers fails to detect a running Docker-compatible environment.

Signed-off-by: Dmytro Nosan <[email protected]>
@spring-projects-issues spring-projects-issues added the status: waiting-for-triage An issue we've not yet triaged label Oct 24, 2025
@snicoll snicoll added type: enhancement A general enhancement and removed status: waiting-for-triage An issue we've not yet triaged labels Oct 27, 2025
@snicoll snicoll added this to the 4.x milestone Oct 27, 2025
@snicoll snicoll mentioned this pull request Oct 27, 2025
Closed
snicoll pushed a commit to snicoll/spring-boot that referenced this pull request Nov 17, 2025
@nosan @snicoll
Add failure analysis for invalid Docker environments
c914f64 
This commit introduces a failure analyzer implementation that provides
actionable guidance when Testcontainers fails to detect a running
Docker-compatible environment.

See spring-projectsgh-47797

Signed-off-by: Dmytro Nosan <[email protected]>
snicoll added a commit to snicoll/spring-boot that referenced this pull request Nov 17, 2025
@snicoll
Polish "Add failure analysis for invalid Docker environments"
7a3393c 
See spring-projectsgh-47797
@snicoll snicoll self-assigned this Nov 17, 2025
@snicoll snicoll modified the milestones: 4.x, 4.1.x Nov 17, 2025
@snicoll
Copy link
Member

snicoll commented Nov 17, 2025

This PR is ready to be merged once main switches to 4.1.0-SNAPSHOT

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

@snicoll snicoll

Labels

type: enhancement A general enhancement

Projects

None yet

Milestone

4.1.x

Development

Successfully merging this pull request may close these issues.

3 participants

@nosan @snicoll @spring-projects-issues