kubernetes/kops · error

method metal.Cloud::DeleteInstance not implemented

Error message

method metal.Cloud::DeleteInstance not implemented

What it means

Stub-method error: metal.Cloud.DeleteInstance is unimplemented, so cloud-driven instance deletion (rolling updates, scale-down) cannot be performed by the metal provider. Fires when instance deletion is requested on bare metal.

Source

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

	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.
func (c *Cloud) DetachInstance(instance *cloudinstances.CloudInstance) error {
	return fmt.Errorf("method metal.Cloud::DetachInstance not implemented")
}

// GetCloudGroups returns a map of cloud instances that back a kops cluster.

View on GitHub (pinned to 4c8573c808)

Solutions

1. Delete bare-metal machines out-of-band (manually or via the metal provisioner)
2. Avoid flows that rely on cloud instance deletion with metal
3. Implement DeleteInstance if metal integration gains deletion support

When it happens

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