kubernetes/kops · error

error listing files in state store: %v

Error message

error listing files in state store: %v

What it means

ReadTree over the cluster's config base in the state store failed while preparing to delete all cluster state; a VFS listing error (bucket permissions, network, or a malformed path) prevents enumeration of files to delete.

Source

Thrown at pkg/client/simple/vfsclientset/clientset.go:143

}

func (c *VFSClientset) pkiPath(cluster *kops.Cluster) (vfs.Path, error) {
	if cluster.Spec.ConfigStore.Keypairs == "" {
		configBase, err := registry.ConfigBase(c.VFSContext(), cluster)
		if err != nil {
			return nil, err
		}
		return configBase.Join("pki"), nil
	} else {
		storePath, err := c.VFSContext().BuildVfsPath(cluster.Spec.ConfigStore.Keypairs)
		return storePath, err
	}
}

func DeleteAllClusterState(ctx context.Context, basePath vfs.Path) error {
	paths, err := basePath.ReadTree(ctx)
	if err != nil {
		return fmt.Errorf("error listing files in state store: %v", err)
	}

	for _, path := range paths {
		relativePath, err := vfs.RelativePath(basePath, path)
		if err != nil {
			return err
		}

		if relativePath == "" {
			continue
		}

		// "cluster.spec" was written by kOps 1.21 and earlier.
		if relativePath == "config" || relativePath == "cluster.spec" || relativePath == "cluster-completed.spec" || relativePath == registry.PathKopsVersionUpdated {
			continue
		}
		if strings.HasPrefix(relativePath, "addons/") {
			continue

View on GitHub (pinned to 4c8573c808)

Solutions

1. Verify the state store path is correct and listable
2. Check bucket credentials and list permissions
3. Retry after restoring connectivity to the state store

When it happens

Trigger: Thrown at pkg/client/simple/vfsclientset/clientset.go:143 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/ce8a5f1acaf0db51. Report an issue: GitHub.