arcbox-migration 0.4.10

Shared logic for migrating Docker objects (images, containers, networks) from Docker Desktop or OrbStack into ArcBox.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

//! Progress types emitted during migration execution.

/// High-level migration stages.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum MigrationStage {
    /// Preparing the migration plan.
    Prepare,
    /// Stopping source containers blocked on volume migration.
    StopSourceContainers,
    /// Importing images.
    ImportImages,
    /// Importing volumes.
    ImportVolumes,
    /// Recreating networks.
    RecreateNetworks,
    /// Recreating containers.
    RecreateContainers,
    /// Cleaning up temporary resources.
    Cleanup,
    /// Migration completed.
    Complete,
}

impl MigrationStage {
    /// Returns a stable string representation.
    #[must_use]
    pub const fn as_str(self) -> &'static str {
        match self {
            Self::Prepare => "prepare",
            Self::StopSourceContainers => "stop-source-containers",
            Self::ImportImages => "import-images",
            Self::ImportVolumes => "import-volumes",
            Self::RecreateNetworks => "recreate-networks",
            Self::RecreateContainers => "recreate-containers",
            Self::Cleanup => "cleanup",
            Self::Complete => "complete",
        }
    }
}

/// Progress update emitted during migration execution.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct MigrationProgress {
    /// Current stage.
    pub stage: MigrationStage,
    /// Human-readable detail.
    pub detail: String,
    /// Resource kind being processed.
    pub resource_type: Option<String>,
    /// Resource name being processed.
    pub resource_name: Option<String>,
    /// Current item index (1-based).
    pub current: Option<u32>,
    /// Total number of items in the current stage.
    pub total: Option<u32>,
}