{"record":{"id":"66e0b5ebcf2e7007","repo":"GoogleContainerTools/skaffold","slug":"resolving-debug-helpers-w","errorCode":null,"errorMessage":"resolving debug helpers: %w","messagePattern":"resolving debug helpers: %w","errorType":"console","errorClass":null,"httpStatus":null,"severity":"error","filePath":"cmd/skaffold/app/cmd/filter.go","lineNumber":121,"sourceCode":"\t\t\treturn err\n\t\t}\n\t\tallow, deny := getTransformList(configs)\n\n\t\tmanifestList, err = manifestList.SetLabels(pkgutil.EnvSliceToMap(opts.CustomLabels, \"=\"),\n\t\t\tmanifest.NewResourceSelectorLabels(allow, deny))\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\tmanifestList, err = manifestList.ReplaceImages(ctx, buildArtifacts, manifest.NewResourceSelectorImages(allow, deny))\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\n\t\tif debuggingFilters {\n\t\t\t// TODO(bdealwis): refactor this code\n\t\t\tdebugHelpersRegistry, err := config.GetDebugHelpersRegistry(opts.GlobalConfig)\n\t\t\tif err != nil {\n\t\t\t\treturn fmt.Errorf(\"resolving debug helpers: %w\", err)\n\t\t\t}\n\t\t\tinsecureRegistries, err := getInsecureRegistries(opts, configs)\n\t\t\tif err != nil {\n\t\t\t\treturn fmt.Errorf(\"retrieving insecure registries: %w\", err)\n\t\t\t}\n\n\t\t\tmanifestList, err = debugging.ApplyDebuggingTransforms(manifestList, buildArtifacts, manifest.Registries{\n\t\t\t\tDebugHelpersRegistry: debugHelpersRegistry,\n\t\t\t\tInsecureRegistries:   insecureRegistries,\n\t\t\t})\n\t\t\tif err != nil {\n\t\t\t\treturn fmt.Errorf(\"transforming manifests: %w\", err)\n\t\t\t}\n\t\t}\n\t\tout.Write([]byte(manifestList.String()))\n\t\treturn nil\n\t})\n}","sourceCodeStart":103,"sourceCodeEnd":139,"githubUrl":"https://github.com/GoogleContainerTools/skaffold/blob/a1189de023efc32d4b8e11f395acc678aa555011/cmd/skaffold/app/cmd/filter.go#L103-L139","documentation":"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.","triggerScenarios":"debuggingFilters is enabled and GetDebugHelpersRegistry reads the skaffold global config file, which is missing, unreadable, or malformed, wrapped at filter.go:121.","commonSituations":"Corrupt or inaccessible ~/.skaffold/config, SKAFFOLD_GLOBAL_CONFIG pointing to a bad path, or global config written by an incompatible Skaffold version.","solutions":["Inspect the wrapped error for the config-file problem","Check ~/.skaffold/config exists and is valid JSON/YAML","Fix or unset SKAFFOLD_GLOBAL_CONFIG / SKAFFOLD_CONFIG env overrides","Back up and regenerate the global config (skaffold config commands)"],"exampleFix":"// before\nSKAFFOLD_GLOBAL_CONFIG=/nonexistent skaffold filter --enable-debugging\n// after\nunset SKAFFOLD_GLOBAL_CONFIG && skaffold filter --enable-debugging","handlingStrategy":"validation","validationCode":"cfg := os.Getenv(\"SKAFFOLD_GLOBAL_CONFIG\")\nif cfg != \"\" {\n    if _, err := os.Stat(cfg); err != nil {\n        return fmt.Errorf(\"SKAFFOLD_GLOBAL_CONFIG %s missing: %w\", cfg, err)\n    }\n}","typeGuard":null,"tryCatchPattern":"if err != nil {\n    return fmt.Errorf(\"resolving debug helpers: %w\", err)\n}\n// caller: fall back to defaults if errors.As points at a config-read failure","preventionTips":["Keep ~/.skaffold/config valid and writable","Do not point SKAFFOLD_GLOBAL_CONFIG at missing files","Regenerate corrupted global config before debugging workflows"],"tags":["cli","skaffold-config","debugging"],"backgroundTag":"missing-config-file","analyzedSha":"a1189de023efc32d4b8e11f395acc678aa555011","analyzedAt":"2026-09-05T12:09:27.064Z","contentChangedAt":"2026-09-05T12:09:27.064Z","schemaVersion":2},"datasetVersion":"2026-09-12T17:17:11.597Z"}