kubernetes/kops · error

method metal.Cloud::FindVPCInfo not implemented

Error message

method metal.Cloud::FindVPCInfo not implemented

What it means

Stub-method error: metal.Cloud.FindVPCInfo is unimplemented because bare metal has no cloud VPC concept. Fires when cluster networking code queries VPC details from the metal provider — a capability gap, not a runtime failure.

Source

Thrown at upup/pkg/fi/cloudup/metal/cloud.go:52

type Cloud struct {
}

// NewCloud returns a Cloud for metal resources.
func NewCloud() (*Cloud, error) {
	cloud := &Cloud{}
	return cloud, nil
}

func (c *Cloud) ProviderID() kops.CloudProviderID {
	return kops.CloudProviderMetal
}
func (c *Cloud) DNS() (dnsprovider.Interface, error) {
	return nil, fmt.Errorf("method metal.Cloud::DNS not implemented")
}

// FindVPCInfo looks up the specified VPC by id, returning info if found, otherwise (nil, nil).
func (c *Cloud) FindVPCInfo(id string) (*fi.VPCInfo, error) {
	return nil, fmt.Errorf("method metal.Cloud::FindVPCInfo not implemented")
}

// DeleteInstance deletes a cloud instance.
func (c *Cloud) DeleteInstance(instance *cloudinstances.CloudInstance) error {
	return fmt.Errorf("method metal.Cloud::DeleteInstance not implemented")
}

// // DeregisterInstance drains a cloud instance and loadbalancers.
func (c *Cloud) DeregisterInstance(instance *cloudinstances.CloudInstance) error {
	return fmt.Errorf("method metal.Cloud::DeregisterInstance not implemented")
}

// DeleteGroup deletes the cloud resources that make up a CloudInstanceGroup, including the instances.
func (c *Cloud) DeleteGroup(group *cloudinstances.CloudInstanceGroup) error {
	return fmt.Errorf("method metal.Cloud::DeleteGroup not implemented")
}

// DetachInstance causes a cloud instance to no longer be counted against the group's size limits.

View on GitHub (pinned to 4c8573c808)

Solutions

1. Do not use VPC-dependent features with the metal provider
2. Supply networking configuration explicitly in the cluster spec
3. Implement FindVPCInfo if metal later supports networks

When it happens

Trigger: Thrown at upup/pkg/fi/cloudup/metal/cloud.go:52 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/2ab3f28dabfae7d6. Report an issue: GitHub.