GoogleContainerTools/skaffold · error

resolving debug helpers: %w

Error message

resolving debug helpers: %w

What it means

Wraps a failure from config.GetDebugHelpersRegistry(opts.GlobalConfig) while preparing debugging transforms in `skaffold filter`. It means Skaffold could not resolve which registry holds debug helper images from the global config.

Source

Thrown at cmd/skaffold/app/cmd/filter.go:121

			return err
		}
		allow, deny := getTransformList(configs)

		manifestList, err = manifestList.SetLabels(pkgutil.EnvSliceToMap(opts.CustomLabels, "="),
			manifest.NewResourceSelectorLabels(allow, deny))
		if err != nil {
			return err
		}
		manifestList, err = manifestList.ReplaceImages(ctx, buildArtifacts, manifest.NewResourceSelectorImages(allow, deny))
		if err != nil {
			return err
		}

		if debuggingFilters {
			// TODO(bdealwis): refactor this code
			debugHelpersRegistry, err := config.GetDebugHelpersRegistry(opts.GlobalConfig)
			if err != nil {
				return fmt.Errorf("resolving debug helpers: %w", err)
			}
			insecureRegistries, err := getInsecureRegistries(opts, configs)
			if err != nil {
				return fmt.Errorf("retrieving insecure registries: %w", err)
			}

			manifestList, err = debugging.ApplyDebuggingTransforms(manifestList, buildArtifacts, manifest.Registries{
				DebugHelpersRegistry: debugHelpersRegistry,
				InsecureRegistries:   insecureRegistries,
			})
			if err != nil {
				return fmt.Errorf("transforming manifests: %w", err)
			}
		}
		out.Write([]byte(manifestList.String()))
		return nil
	})
}

View on GitHub (pinned to a1189de023)

Solutions

1. Inspect the wrapped error for the config-file problem
2. Check ~/.skaffold/config exists and is valid JSON/YAML
3. Fix or unset SKAFFOLD_GLOBAL_CONFIG / SKAFFOLD_CONFIG env overrides
4. Back up and regenerate the global config (skaffold config commands)

Example fix

// before
SKAFFOLD_GLOBAL_CONFIG=/nonexistent skaffold filter --enable-debugging
// after
unset SKAFFOLD_GLOBAL_CONFIG && skaffold filter --enable-debugging

cfg := os.Getenv("SKAFFOLD_GLOBAL_CONFIG")
if cfg != "" {
    if _, err := os.Stat(cfg); err != nil {
        return fmt.Errorf("SKAFFOLD_GLOBAL_CONFIG %s missing: %w", cfg, err)
    }
}

if err != nil {
    return fmt.Errorf("resolving debug helpers: %w", err)
}
// caller: fall back to defaults if errors.As points at a config-read failure

When it happens

Trigger: debuggingFilters is enabled and GetDebugHelpersRegistry reads the skaffold global config file, which is missing, unreadable, or malformed, wrapped at filter.go:121.

Common situations: Corrupt or inaccessible ~/.skaffold/config, SKAFFOLD_GLOBAL_CONFIG pointing to a bad path, or global config written by an incompatible Skaffold version.

Related errors

• retrieving insecure registries: %w
• transforming manifests: %w
• `apply` requires at least one manifest argument
• `exec` requires exactly one action to execute
• `config-dependencies add` requires exactly one file path arg

AI-assisted analysis of GoogleContainerTools/skaffold@a1189de023 (2026-09-05). Data as JSON: /api/errors/66e0b5ebcf2e7007. Report an issue: GitHub.