kubernetes/kops · error

parsing ip address %q (bound to network %q): %w

Error message

parsing ip address %q (bound to network %q): %w

What it means

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.

Source

Thrown at nodeup/pkg/model/kube_apiserver.go:98

	}

	if b.CloudProvider() == kops.CloudProviderMetal {
		// Workaround for https://github.com/kubernetes/kubernetes/issues/111671
		if b.IsIPv6Only() {
			interfaces, err := net.Interfaces()
			if err != nil {
				return fmt.Errorf("getting local network interfaces: %w", err)
			}
			var ipv6s []net.IP
			for _, intf := range interfaces {
				addresses, err := intf.Addrs()
				if err != nil {
					return fmt.Errorf("getting addresses for network interface %q: %w", intf.Name, err)
				}
				for _, addr := range addresses {
					ip, _, err := net.ParseCIDR(addr.String())
					if ip == nil {
						return fmt.Errorf("parsing ip address %q (bound to network %q): %w", addr.String(), intf.Name, err)
					}
					if ip.To4() != nil {
						// We're only looking for ipv6
						continue
					}
					if ip.IsLinkLocalUnicast() {
						klog.V(4).Infof("ignoring link-local unicast addr %v", addr)
						continue
					}
					if ip.IsLinkLocalMulticast() {
						klog.V(4).Infof("ignoring link-local multicast addr %v", addr)
						continue
					}
					if ip.IsLoopback() {
						klog.V(4).Infof("ignoring loopback addr %v", addr)
						continue
					}
					ipv6s = append(ipv6s, ip)

View on GitHub (pinned to 4c8573c808)

Solutions

1. Inspect the interface addresses with ip addr
2. Report unexpected address formats to kOps maintainers
3. Re-run nodeup

When it happens

Trigger: Thrown at nodeup/pkg/model/kube_apiserver.go:98 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of kubernetes/kops@4c8573c808 (2026-09-05). Data as JSON: /api/errors/f931ef821c724696. Report an issue: GitHub.