{"record":{"id":"7933330d42e9cf8a","repo":"kubernetes/kops","slug":"local-ipv4-from-aws-metadata-is-not-a-valid-ipv4-a","errorCode":null,"errorMessage":"local-ipv4 from AWS metadata is not a valid IPv4 address: %q","messagePattern":"local-ipv4 from AWS metadata is not a valid IPv4 address: %q","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"upup/pkg/fi/nodeup/command.go","lineNumber":515,"sourceCode":"\t\t//\n\t\t// An instance launched with a resource-based hostname keeps a resource-based name (it can\n\t\t// only change while the instance is stopped), so an IP-based node name would not match its\n\t\t// EC2 hostname; fail rather than join a misconfigured instance.\n\t\thostnameBytes, err := vfs.Context.ReadFile(\"metadata://aws/meta-data/local-hostname\")\n\t\tif err != nil {\n\t\t\treturn \"\", fmt.Errorf(\"error reading local-hostname from AWS metadata: %v\", err)\n\t\t}\n\t\tif strings.HasPrefix(string(hostnameBytes), instanceID) {\n\t\t\treturn \"\", fmt.Errorf(\"instance %s was launched with a resource-based hostname; useIPBasedNodeNames requires subnets that assign IP-based hostnames\", instanceID)\n\t\t}\n\n\t\tlocalIPv4Bytes, err := vfs.Context.ReadFile(\"metadata://aws/meta-data/local-ipv4\")\n\t\tif err != nil {\n\t\t\treturn \"\", fmt.Errorf(\"error reading local-ipv4 from AWS metadata: %v\", err)\n\t\t}\n\t\tlocalIPv4 := string(localIPv4Bytes)\n\t\tif net.ParseIP(localIPv4).To4() == nil {\n\t\t\treturn \"\", fmt.Errorf(\"local-ipv4 from AWS metadata is not a valid IPv4 address: %q\", localIPv4)\n\t\t}\n\n\t\treturn awsbootstrap.PrivateDNSName(localIPv4, region), nil\n\n\tcase api.CloudProviderGCE:\n\t\t// This lets us tolerate broken hostnames (i.e. systemd)\n\t\tb, err := vfs.Context.ReadFile(\"metadata://gce/instance/hostname\")\n\t\tif err != nil {\n\t\t\treturn \"\", fmt.Errorf(\"error reading hostname from GCE metadata: %v\", err)\n\t\t}\n\n\t\t// We only want to use the first portion of the fully-qualified name\n\t\t// e.g. foo.c.project.internal => foo\n\t\tfullyQualified := string(b)\n\t\tbareHostname := strings.Split(fullyQualified, \".\")[0]\n\t\treturn bareHostname, nil\n\tcase api.CloudProviderDO:\n\t\tvBytes, err := vfs.Context.ReadFile(\"metadata://digitalocean/interfaces/private/0/ipv4/address\")","sourceCodeStart":497,"sourceCodeEnd":533,"githubUrl":"https://github.com/kubernetes/kops/blob/4c8573c808a73d578c5eadc86d410646ea0b0d73/upup/pkg/fi/nodeup/command.go#L497-L533","documentation":"Error \"local-ipv4 from AWS metadata is not a valid IPv4 address: %q\" thrown in kubernetes/kops.","triggerScenarios":"Thrown at upup/pkg/fi/nodeup/command.go:515 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"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-12T07:17:12.445Z"}