goreleaser/goreleaser · error

nodedist: no embedded entry for %s; run `task nodedist:relea

Error message

nodedist: no embedded entry for %s; run `task nodedist:releases:generate` (or update goreleaser)

What it means

Lookup error in nodedist.lookupSHA: the embedded releases.json has no entry at all for the requested Node version. The pinned SHA data is generated into the binary, so an unknown version cannot be integrity-checked; the error tells you to regenerate the embedded data or update goreleaser.

Source

Thrown at internal/nodedist/releases.go:32

// and cached for the lifetime of the process. Each entry maps an
// archive name (matching what Target.ArchiveName returns) to its
// SHA-256, hex-encoded.
var Releases = sync.OnceValue(func() map[string]map[string]string {
	var m map[string]map[string]string
	if err := json.Unmarshal(rawReleases, &m); err != nil {
		panic(fmt.Sprintf("nodedist: decode embedded releases.json: %v", err))
	}
	return m
})

// lookupSHA returns the embedded SHA-256 for the given (version,
// archiveName). Both arguments must match the upstream layout exactly
// (version with leading `v`, archiveName as published in
// SHASUMS256.txt). Returns an actionable error when missing.
func lookupSHA(version, archiveName string) (string, error) {
	files, ok := Releases()[version]
	if !ok {
		return "", fmt.Errorf("nodedist: no embedded entry for %s; run `task nodedist:releases:generate` (or update goreleaser)", version)
	}
	sha, ok := files[archiveName]
	if !ok {
		return "", fmt.Errorf("nodedist: no embedded SHA for %s/%s; run `task nodedist:releases:generate` (or update goreleaser)", version, archiveName)
	}
	return sha, nil
}

View on GitHub (pinned to f5edd73956)

Solutions

  1. Update goreleaser to a version whose embedded releases.json covers the requested node version
  2. Regenerate the embedded data via `task nodedist:releases:generate`
  3. Use a node version that exists in the embedded manifest
Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at internal/nodedist/releases.go:32 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of goreleaser/goreleaser@f5edd73956 (2026-09-05). Data as JSON: /api/errors/27e7a33838400d23. Report an issue: GitHub.