kubernetes/kops · error

Invalud URL for file %q: %v

Error message

Invalud URL for file %q: %v

What it means

downloadURLToWriter parses the source URL with url.Parse before fetching it. Any malformed URL is reported with this (typo'd 'Invalud') message. Note: url.Parse is lenient — this fires only for structurally invalid URLs.

Source

Thrown at upup/pkg/fi/http.go:87

	}
	if err != nil {
		return nil, err
	}
	if err := os.Chmod(tempPath, 0o644); err != nil {
		return nil, fmt.Errorf("error setting mode on downloaded file %q: %v", tempPath, err)
	}
	if err := os.Rename(tempPath, destPath); err != nil {
		return nil, fmt.Errorf("error moving downloaded file %q to %q: %v", tempPath, destPath, err)
	}
	return actual, nil
}

// downloadURLToWriter streams the file at the given url to dest.
// If hash is non-nil, it will also verify that it matches the downloaded bytes.
func downloadURLToWriter(ctx context.Context, desturl string, dest io.Writer, hash *hashing.Hash) (*hashing.Hash, error) {
	u, err := url.Parse(desturl)
	if err != nil {
		return nil, fmt.Errorf("Invalud URL for file %q: %v", desturl, err)
	}

	start := time.Now()
	defer func() {
		klog.V(2).Infof("Downloading %q took %q", desturl, time.Since(start))
	}()
	klog.V(2).Infof("Downloading %q", desturl)

	algorithm := hashing.HashAlgorithmSHA256
	if hash != nil {
		algorithm = hash.Algorithm
	}
	hasher := algorithm.NewHasher()
	writer := io.MultiWriter(dest, hasher)

	switch u.Scheme {
	case "gs", "s3", "azureblob":
		// vfs resolves the bucket and signs the request with the ambient cloud credentials,

View on GitHub (pinned to 4c8573c808)

Solutions

1. Inspect the wrapped %v error for the exact parse failure and character offset
2. Correct the URL in your cluster spec / asset configuration
3. Re-run the command with the fixed URL

Example fix

// before
url: "https://example.com/path%zzfile.tgz"
// after
url: "https://example.com/path%7Bfile%7D.tgz"

u, err := url.Parse(assetURL)
if err != nil || u.Scheme == "" || u.Host == "" {
    return fmt.Errorf("asset URL is not an absolute valid URL: %q", assetURL)
}

if _, err := fi.DownloadURL(ctx, assetURL, dest, nil); err != nil {
    if strings.Contains(err.Error(), "Invalud URL") {
        return fmt.Errorf("fix the malformed URL in your spec: %w", err)
    }
    return err
}

When it happens

Trigger: url.Parse(desturl) returns an error: control characters in the URL, malformed percent-encoding, or otherwise unparsable scheme/path.

Common situations: Cluster spec references an asset URL with embedded spaces/newlines or bad escapes (e.g. %zz) in kops_spec assets, base images, or mirror configuration.

Understand the failure class

Background: "Invalid URL" / "URL cannot be empty": fix the malformed or missing URL behind request-construction failures — this error's family across 50 libraries.

Related errors

• invalid addon location: %q
• failed to parse objects: %w
• failed to parse apiVersion %q
• failed to find kind in object
• at least one channel URL is required

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