kubernetes/kops · error

error attaching volume %s to server %s: %v

Error message

error attaching volume %s to server %s: %v

What it means

Attaching a Cinder volume to a server failed at the API level. The operation is retried with backoff; typical failures are attaching to a non-ACTIVE server, volume in a non-available state, or conflicts.

Source

Thrown at upup/pkg/fi/cloudup/openstack/volume.go:91

	})
	if err != nil {
		return volume, err
	} else if done {
		return volume, nil
	} else {
		return volume, wait.ErrWaitTimeout
	}
}

func (c *openstackCloud) AttachVolume(serverID string, opts volumeattach.CreateOpts) (attachment *volumeattach.VolumeAttachment, err error) {
	return attachVolume(c, serverID, opts)
}

func attachVolume(c OpenstackCloud, serverID string, opts volumeattach.CreateOpts) (attachment *volumeattach.VolumeAttachment, err error) {
	done, err := vfs.RetryWithBackoff(writeBackoff, func() (bool, error) {
		volumeAttachment, err := volumeattach.Create(context.TODO(), c.ComputeClient(), serverID, opts).Extract()
		if err != nil {
			return false, fmt.Errorf("error attaching volume %s to server %s: %v", opts.VolumeID, serverID, err)
		}
		attachment = volumeAttachment
		return true, nil
	})
	if !done {
		if err == nil {
			err = wait.ErrWaitTimeout
		}
		return attachment, err
	}
	return attachment, err
}

func (c *openstackCloud) SetVolumeTags(id string, tags map[string]string) error {
	return setVolumeTags(c, id, tags)
}

func setVolumeTags(c OpenstackCloud, id string, tags map[string]string) error {

View on GitHub (pinned to 4c8573c808)

Solutions

1. Ensure the server is ACTIVE and the volume is available
2. Inspect the wrapped error for the conflict
3. Retry the attachment once states allow

When it happens

Trigger: Thrown at upup/pkg/fi/cloudup/openstack/volume.go:91 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/8ddc3e9e5b814932. Report an issue: GitHub.