{"record":{"id":"f931ef821c724696","repo":"kubernetes/kops","slug":"parsing-ip-address-q-bound-to-network-q-w","errorCode":null,"errorMessage":"parsing ip address %q (bound to network %q): %w","messagePattern":"parsing ip address %q \\(bound to network %q\\): %w","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"nodeup/pkg/model/kube_apiserver.go","lineNumber":98,"sourceCode":"\t}\n\n\tif b.CloudProvider() == kops.CloudProviderMetal {\n\t\t// Workaround for https://github.com/kubernetes/kubernetes/issues/111671\n\t\tif b.IsIPv6Only() {\n\t\t\tinterfaces, err := net.Interfaces()\n\t\t\tif err != nil {\n\t\t\t\treturn fmt.Errorf(\"getting local network interfaces: %w\", err)\n\t\t\t}\n\t\t\tvar ipv6s []net.IP\n\t\t\tfor _, intf := range interfaces {\n\t\t\t\taddresses, err := intf.Addrs()\n\t\t\t\tif err != nil {\n\t\t\t\t\treturn fmt.Errorf(\"getting addresses for network interface %q: %w\", intf.Name, err)\n\t\t\t\t}\n\t\t\t\tfor _, addr := range addresses {\n\t\t\t\t\tip, _, err := net.ParseCIDR(addr.String())\n\t\t\t\t\tif ip == nil {\n\t\t\t\t\t\treturn fmt.Errorf(\"parsing ip address %q (bound to network %q): %w\", addr.String(), intf.Name, err)\n\t\t\t\t\t}\n\t\t\t\t\tif ip.To4() != nil {\n\t\t\t\t\t\t// We're only looking for ipv6\n\t\t\t\t\t\tcontinue\n\t\t\t\t\t}\n\t\t\t\t\tif ip.IsLinkLocalUnicast() {\n\t\t\t\t\t\tklog.V(4).Infof(\"ignoring link-local unicast addr %v\", addr)\n\t\t\t\t\t\tcontinue\n\t\t\t\t\t}\n\t\t\t\t\tif ip.IsLinkLocalMulticast() {\n\t\t\t\t\t\tklog.V(4).Infof(\"ignoring link-local multicast addr %v\", addr)\n\t\t\t\t\t\tcontinue\n\t\t\t\t\t}\n\t\t\t\t\tif ip.IsLoopback() {\n\t\t\t\t\t\tklog.V(4).Infof(\"ignoring loopback addr %v\", addr)\n\t\t\t\t\t\tcontinue\n\t\t\t\t\t}\n\t\t\t\t\tipv6s = append(ipv6s, ip)","sourceCodeStart":80,"sourceCodeEnd":116,"githubUrl":"https://github.com/kubernetes/kops/blob/4c8573c808a73d578c5eadc86d410646ea0b0d73/nodeup/pkg/model/kube_apiserver.go#L80-L116","documentation":"Same IPv6-only metal workaround: after ParseCIDR, the code verifies the parsed address is a global unicast IPv6 address; this error fires when an address bound to the interface is not usable (e.g. link-local fe80:: or a non-CIDR value). It is per-address filtering — the builder continues to other addresses, and only surfaces when no valid global IPv6 was found.","triggerScenarios":"Thrown at nodeup/pkg/model/kube_apiserver.go:98 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Inspect the interface addresses with ip addr","Report unexpected address formats to kOps maintainers","Re-run nodeup"],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"4c8573c808a73d578c5eadc86d410646ea0b0d73","analyzedAt":"2026-09-05T04:13:19.212Z","contentChangedAt":"2026-09-05T04:13:19.212Z","schemaVersion":2},"datasetVersion":"2026-09-12T12:17:11.808Z"}