Modern Docker Management, Designed for Everyone
Go composecontainer-managementcontainersdockerdocker-composedocker-managementgoself-hostedsveltekittypescriptweb-ui
package volume
import (
"context"
"fmt"
"strings"
"github.com/moby/moby/api/types/volume"
"github.com/moby/moby/client"
)
// RenameEntry describes a source volume and the target configuration for a copy-based rename.
type RenameEntry struct {
Key string
OldName string
NewName string
OldVolume volume.Volume
CreateOptions client.VolumeCreateOptions
}
type Migration interface {
Apply(ctx context.Context) error
Rollback(ctx context.Context) error
}
type Committer interface {
Commit(ctx context.Context) error
}
type JournalSource interface {
JournalVolumes() []JournalVolume
}
type JournalVolume struct {
Key string `json:"key"`
OldName string `json:"oldName"`
NewName string `json:"newName"`
Driver string `json:"driver,omitempty"`
Options map[string]string `json:"options,omitempty"`
Labels map[string]string `json:"labels,omitempty"`
}
type ProjectVolumeRenameConflictError struct {
VolumeName string
}
type ProjectVolumeRenameInUseError struct {
VolumeName string
ContainerIDs []string
}
type ProjectVolumeRenameInsufficientSpaceError struct {
SourceVolume string
TargetVolume string
Detail string
}
type TargetMissingWithSourceError struct {
SourceVolume string
TargetVolume string
}
type SourceCleanupError struct {
SourceVolume string
Err error
}
type TargetPreservedDuringRollbackError struct {
SourceVolume string
TargetVolume string
Err error
}
type VolumesExternallyRemovedError struct {
Volumes []JournalVolume
}
func (e *VolumesExternallyRemovedError) Error() string {
if e == nil || len(e.Volumes) == 0 {
return "committed project rename source and target volumes are both missing"
}
if len(e.Volumes) == 1 {
vol := e.Volumes[0]
return fmt.Sprintf("committed project rename target volume %s is missing and source volume %s is also missing", vol.NewName, vol.OldName)
}
return fmt.Sprintf("committed project rename source and target volumes are both missing for %d volume pairs", len(e.Volumes))
}
func (e *TargetPreservedDuringRollbackError) Unwrap() error {
return e.Err
}
func (e *TargetPreservedDuringRollbackError) Error() string {
return fmt.Sprintf("preserved project rename target volume %s during rollback to avoid data loss; source volume %s was not safe to rely on: %v", e.TargetVolume, e.SourceVolume, e.Err)
}
func (e *SourceCleanupError) Unwrap() error {
if e == nil {
return nil
}
return e.Err
}
func (e *SourceCleanupError) Error() string {
if e == nil {
return "clean up committed project rename source volume"
}
if strings.TrimSpace(e.SourceVolume) == "" {
return fmt.Sprintf("clean up committed project rename source volume: %v", e.Err)
}
return fmt.Sprintf("clean up committed project rename source volume %s: %v", e.SourceVolume, e.Err)
}
func (e *TargetMissingWithSourceError) Error() string {
return fmt.Sprintf("committed project rename target volume %s is missing while source volume %s still exists", e.TargetVolume, e.SourceVolume)
}
func (e *ProjectVolumeRenameInsufficientSpaceError) Error() string {
msg := "insufficient disk space to rename project volume"
if e.SourceVolume != "" && e.TargetVolume != "" {
msg = fmt.Sprintf("insufficient disk space to copy volume %s to %s", e.SourceVolume, e.TargetVolume)
}
if strings.TrimSpace(e.Detail) != "" {
msg += ": " + strings.TrimSpace(e.Detail)
}
return msg
}
func (e *ProjectVolumeRenameInUseError) Error() string {
if strings.TrimSpace(e.VolumeName) == "" {
return "source volume is still attached to containers"
}
if len(e.ContainerIDs) == 0 {
return "source volume is still attached to containers: " + e.VolumeName
}
return fmt.Sprintf("source volume is still attached to %d container(s): %s", len(e.ContainerIDs), e.VolumeName)
}
func (e *ProjectVolumeRenameConflictError) Error() string {
if strings.TrimSpace(e.VolumeName) == "" {
return "target volume already exists"
}
return "target volume already exists: " + e.VolumeName
}