Function _start_docker_windows

ci/util/docker_helper.py:258–331

Attempt to start Docker Desktop on Windows with WSL2 backend diagnostics. Returns: Tuple of (success, message)

()

def _start_docker_windows() -> tuple[bool, str]:
    """Attempt to start Docker Desktop on Windows with WSL2 backend diagnostics.

    Returns:
        Tuple of (success, message)
    """
    try:
        # First, check if Docker is already running
        if is_docker_available():
            return True, "Docker is already running"

        # Check WSL2 backend status
        print("  Checking Docker Desktop WSL2 backend status...", flush=True)
        wsl_running, wsl_message = _check_wsl2_docker_backend()
        print(f"  WSL2 Status: {wsl_message}", flush=True)

        # If Docker Desktop is installed but WSL2 backend is stopped, restart it
        if not wsl_running and "stopped" in wsl_message.lower():
            print(
                "  Issue detected: Docker Desktop app may be running but WSL2 backend is stopped",
                flush=True,
            )
            return _restart_docker_desktop_windows()

        # Try to start Docker Desktop via the executable
        docker_path = _find_docker_desktop_executable()

        if docker_path:
            try:
                print("  Starting Docker Desktop...", flush=True)
                subprocess.Popen(
                    [docker_path],
                    stdout=subprocess.DEVNULL,
                    stderr=subprocess.DEVNULL,
                )
                # Wait for Docker to start - Docker Desktop can take 60+ seconds
                print("  Waiting for Docker Desktop to initialize...", flush=True)
                # Try for up to 120 seconds (2 minutes)
                for attempt in range(120):
                    time.sleep(1)
                    if is_docker_available():
                        # Verify WSL2 backend is also running
                        wsl_running, wsl_msg = _check_wsl2_docker_backend()
                        if wsl_running:
                            return True, "Docker Desktop started successfully"
                        else:
                            print(f"  Warning: {wsl_msg}", flush=True)

                    # Print progress every 10 seconds
                    if (attempt + 1) % 10 == 0:
                        print(f"  Still waiting ({attempt + 1}s)...", flush=True)

                # If we got here, Docker didn't start properly - try restart
                print(
                    "  Docker Desktop didn't start properly, attempting full restart...",
                    flush=True,
                )
                return _restart_docker_desktop_windows()