GoogleContainerTools/skaffold · error

getting image index: %w

Error message

getting image index: %w

What it means

Fires in AddRemoteTag when copying a multi-platform tag: the source image's index (manifest list) cannot be fetched from the remote registry, so the tag cannot be re-pointed for all platforms. Wraps the remote.Index retrieval failure (auth, network, or missing image).

Source

Thrown at pkg/skaffold/docker/remote.go:54

// for testing
var (
	RemoteDigest = getRemoteDigest
	remoteImage  = remote.Image
	remoteIndex  = remote.Index
)

func AddRemoteTag(src, target string, cfg Config, platforms []specs.Platform) error {
	log.Entry(context.TODO()).Debugf("attempting to add tag %s to src %s", target, src)

	targetRef, err := parseReference(target, cfg, name.WeakValidation)
	if err != nil {
		return err
	}

	if len(platforms) > 1 {
		index, err := getRemoteIndex(src, cfg)
		if err != nil {
			return fmt.Errorf("getting image index: %w", err)
		}
		return remote.WriteIndex(targetRef, index, remote.WithAuthFromKeychain(primaryKeychain))
	}

	var pl v1.Platform
	if len(platforms) == 1 {
		pl = util.ConvertToV1Platform(platforms[0])
	}
	img, err := getRemoteImage(src, cfg, pl)
	if err != nil {
		return fmt.Errorf("getting image: %w", err)
	}

	return remote.Write(targetRef, img, remote.WithAuthFromKeychain(primaryKeychain))
}

func getRemoteDigest(identifier string, cfg Config, platforms []specs.Platform) (string, error) {
	idx, err := getRemoteIndex(identifier, cfg)

View on GitHub (pinned to a1189de023)

Solutions

1. Verify the source image exists in the registry (skopeo/crane ls or registry UI)
2. Check registry credentials used by skaffold match those that can read the source image
3. Fix network/proxy connectivity to the registry

When it happens

Trigger: Thrown at pkg/skaffold/docker/remote.go:54 when the library encounters an invalid state.

Common situations: See trigger scenarios.

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