SOLO-2023

KindClusterNetworkSetupFailedSoloError — Deployment

KindClusterNetworkSetupFailedSoloError

CodeSOLO-2023
CategoryDeployment
OwnershipInfrastructure
RetryableNo

Description

Thrown when solo cannot configure networking for a Kind cluster — either the Kind network setup itself or the MetalLB Helm repository configuration it depends on; the underlying failure is wrapped in cause. solo configures MetalLB so that LoadBalancer services in the local Kind cluster receive reachable addresses, and raises this when that setup fails. Common roots are Docker not running (Kind needs it), an unreachable or misconfigured Helm repository, or a problem with the Kind cluster’s Docker network.

Troubleshooting Steps

  1. Check solo logs: tail -n 100 ~/.solo/logs/solo.log
  2. Verify Docker is running: docker ps
  3. Check existing Kind clusters: kind get clusters
  4. Verify Helm repository access: helm repo list