kubernetes/kops · error

cannot load kubecfg settings for %q: %v

Error message

cannot load kubecfg settings for %q: %v

What it means

Raised in checkControlPlaneRunningVersion when a kubeconfig client config for the named cluster context cannot be built. There is no usable kubeconfig entry/context for this cluster name, so the running control-plane version cannot be queried from the API server.

Source

Thrown at cmd/kops/update_cluster.go:640

			if !ok {
				continue
			}
			if ig.Spec.Role == instanceGroupRole {
				return true
			}
		}
		return false
	}
}

// checkControlPlaneRunningVersion returns the minimum control plane running version
func checkControlPlaneRunningVersion(ctx context.Context, clusterName string, version string) (string, error) {
	configLoadingRules := clientcmd.NewDefaultClientConfigLoadingRules()
	config, err := clientcmd.NewNonInteractiveDeferredLoadingClientConfig(
		configLoadingRules,
		&clientcmd.ConfigOverrides{CurrentContext: clusterName}).ClientConfig()
	if err != nil {
		return version, fmt.Errorf("cannot load kubecfg settings for %q: %v", clusterName, err)
	}

	k8sClient, err := kubernetes.NewForConfig(config)
	if err != nil {
		return version, fmt.Errorf("cannot build kubernetes api client for %q: %v", clusterName, err)
	}

	parsedVersion, err := apisutil.ParseKubernetesVersion(version)
	if err != nil {
		return version, fmt.Errorf("cannot parse kubernetes version %q: %v", clusterName, err)
	}
	nodeList, err := k8sClient.CoreV1().Nodes().List(ctx, metav1.ListOptions{
		LabelSelector: "node-role.kubernetes.io/control-plane",
	})
	if err != nil {
		return version, fmt.Errorf("cannot list nodes in cluster %q: %v", clusterName, err)
	}
	for _, node := range nodeList.Items {

View on GitHub (pinned to 4c8573c808)

Solutions

1. Run kops export kubecfg to create the context
2. Verify KUBECONFIG points at the right file
3. Ensure the cluster API server is reachable

When it happens

Trigger: Thrown at cmd/kops/update_cluster.go:640 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/ed48b862d023a56e. Report an issue: GitHub.