Method planRecreateVolume

pkg/compose/reconcile.go:276–323

planRecreateVolume adds the full sequence for a diverged volume: stop affected containers → remove containers → remove volume → create volume. Containers must be removed (not just stopped) because Docker does not allow removing a volume that is referenced by any container, even a stopped one. nolin

(key string, vol *types.VolumeConfig)

//
//nolint:unused // see reconciler.prompt field doc — seam consolidation.
func (r *reconciler) planRecreateVolume(key string, vol *types.VolumeConfig) {
	observed := r.observed.Volumes[key]
	affectedServices := r.servicesUsingVolume(key)
	affectedContainers := r.containersForServices(affectedServices)

	// Stop all affected containers
	var stopNodes []*PlanNode
	for i := range affectedContainers {
		oc := &affectedContainers[i]
		node := r.plan.addNode(Operation{
			Type:       OpStopContainer,
			ResourceID: fmt.Sprintf("service:%s:%d", oc.Summary.Labels[api.ServiceLabel], oc.Number),
			Cause:      fmt.Sprintf("volume %s config changed", key),
			Container:  &oc.Summary,
		}, "")
		stopNodes = append(stopNodes, node)
	}

	// Remove all affected containers (each depends on its own stop)
	var removeNodes []*PlanNode
	for i, oc := range affectedContainers {
		node := r.plan.addNode(Operation{
			Type:       OpRemoveContainer,
			ResourceID: fmt.Sprintf("service:%s:%d", oc.Summary.Labels[api.ServiceLabel], oc.Number),
			Cause:      fmt.Sprintf("volume %s config changed", key),
			Container:  &affectedContainers[i].Summary,
		}, "", stopNodes[i])
		removeNodes = append(removeNodes, node)
	}

	// Remove the *observed* volume (depends on all container removals)
	removeVolNode := r.plan.addNode(Operation{
		Type:       OpRemoveVolume,
		ResourceID: fmt.Sprintf("volume:%s", key),
		Cause:      "config hash diverged",
		Name:       observed.Name,
	}, "", removeNodes...)

	// Create volume (depends on remove)
	createNode := r.plan.addNode(Operation{
		Type:       OpCreateVolume,
		ResourceID: fmt.Sprintf("volume:%s", key),
		Cause:      "recreate after config change",
		Name:       vol.Name,
		Volume:     vol,
	}, "", removeVolNode)
	r.volumeNodes[key] = createNode
}

// servicesUsingNetwork returns the names of services that reference the given
// compose network key, sorted for deterministic plan output.