kubernetes/kops · error

failed to fetch port for instance %v: %v

Error message

failed to fetch port for instance %v: %v

What it means

Listing Neutron ports filtered by the server's device ID failed while building the actual instance state. The wrapped error identifies the API failure; port discovery is required to attach the port task.

Source

Thrown at upup/pkg/fi/cloudup/openstacktasks/instance.go:211

	server := filteredList[0]
	actual := &Instance{
		ID:               new(server.ID),
		Name:             e.Name,
		SSHKey:           new(server.KeyName),
		Lifecycle:        e.Lifecycle,
		Metadata:         server.Metadata,
		Role:             new(server.Metadata["KopsRole"]),
		AvailabilityZone: e.AvailabilityZone,
		GroupName:        e.GroupName,
		ConfigDrive:      e.ConfigDrive,
		Status:           new(server.Status),
	}

	ports, err := cloud.ListPorts(ports.ListOpts{
		DeviceID: server.ID,
	})
	if err != nil {
		return nil, fmt.Errorf("failed to fetch port for instance %v: %v", server.ID, err)
	}

	ports = filterInstancePorts(ports, fi.ValueOf(e.ServerGroup.ClusterName))

	if len(ports) == 1 {
		port := ports[0]
		porttask, err := newPortTaskFromCloud(cloud, e.Lifecycle, &port, nil)
		if err != nil {
			return nil, fmt.Errorf("failed to fetch port for instance %v: %v", server.ID, err)
		}
		actual.Port = porttask

	} else if len(ports) > 1 {
		return nil, fmt.Errorf("found more than one port for instance %v", server.ID)
	}

	if e.FloatingIP != nil && e.Port != nil {
		fips, err := cloud.ListL3FloatingIPs(l3floatingip.ListOpts{

View on GitHub (pinned to 4c8573c808)

Solutions

  1. Inspect the wrapped Neutron error
  2. Verify networking endpoint and credentials
  3. Retry after service restoration
Defensive patterns

Strategy: retry

When it happens

Trigger: Thrown at upup/pkg/fi/cloudup/openstacktasks/instance.go:211 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/dfafa235dcfb706d. Report an issue: GitHub.