kubernetes/kops · error

error reading addons file %s: %v

Error message

error reading addons file %s: %v

What it means

Reading the addons manifest from the state store failed with an error other than not-exist (which is handled by returning nil); i.e. a permission or I/O problem on the VFS path during List.

Source

Thrown at pkg/client/simple/vfsclientset/addons.go:107

	}

	rs := bytes.NewReader(b)
	if err := configPath.WriteFile(ctx, rs, acl); err != nil {
		return fmt.Errorf("error writing addons file %s: %v", configPath, err)
	}

	return nil
}

func (c *vfsAddonsClient) List(ctx context.Context) (kubemanifest.ObjectList, error) {
	configPath := c.basePath.Join("default")

	b, err := configPath.ReadFile(ctx)
	if err != nil {
		if os.IsNotExist(err) {
			return nil, nil
		}
		return nil, fmt.Errorf("error reading addons file %s: %v", configPath, err)
	}

	objects, err := kubemanifest.LoadObjectsFrom(b)
	if err != nil {
		return nil, err
	}

	return objects, nil
}

View on GitHub (pinned to 4c8573c808)

Solutions

1. Check read permissions on the state store path
2. Verify the file is accessible (e.g. not blocked by bucket KMS/encryption policy)
3. Retry after ruling out transient network issues

When it happens

Trigger: Thrown at pkg/client/simple/vfsclientset/addons.go:107 when the library encounters an invalid state.

Common situations: See trigger scenarios.

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