kubernetes/kops · error

invalid kops server url: %q

Error message

invalid kops server url: %q

What it means

Guard in Factory.KopsClient for k8s:// state-store paths: the registry URL after the scheme could not be parsed by url.Parse. Only well-formed k8s://host/path URLs are accepted for the Kubernetes-backed state store.

Source

Thrown at cmd/kops/util/factory.go:116

	if f.clientset == nil {
		registryPath := f.options.RegistryPath
		klog.V(2).Infof("state store %s", registryPath)
		if registryPath == "" {
			return nil, field.Required(field.NewPath("State Store"), STATE_ERROR)
		}

		// We recognize a `k8s` scheme; this might change in future so we won't document it yet
		// In practice nobody is going to hit this accidentally, so I don't think we need a feature flag.
		if strings.HasPrefix(registryPath, "k8s://") {
			loadingRules := clientcmd.NewDefaultClientConfigLoadingRules()

			configOverrides := &clientcmd.ConfigOverrides{}

			if registryPath == "k8s://" {
			} else {
				u, err := url.Parse(registryPath)
				if err != nil {
					return nil, fmt.Errorf("invalid kops server url: %q", registryPath)
				}
				configOverrides.CurrentContext = u.Host
			}

			kubeConfig := clientcmd.NewNonInteractiveDeferredLoadingClientConfig(loadingRules, configOverrides)
			config, err := kubeConfig.ClientConfig()
			if err != nil {
				return nil, fmt.Errorf("error loading kubeconfig for %q", registryPath)
			}

			kopsClient, err := kopsclient.NewForConfig(config)
			if err != nil {
				return nil, fmt.Errorf("error building kops API client: %v", err)
			}

			f.clientset = api.NewRESTClientset(
				f.VFSContext(),
				&url.URL{

View on GitHub (pinned to 4c8573c808)

Solutions

1. Fix the k8s:// URL syntax in --state
2. Use a standard s3:// or gs:// state path instead
3. Ensure the URL has a valid host portion

When it happens

Trigger: Thrown at cmd/kops/util/factory.go:116 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/addba7e30bb4b689. Report an issue: GitHub.