Method run

core/station/impl/src/migration.rs:18–48

Run migrations for the station canister to ensure the stable memory schema is up-to-date. WARNING: This needs to be run before any other access to stable memory happens.

()

    ///
    /// WARNING: This needs to be run before any other access to stable memory happens.
    pub fn run() {
        let mut system_info = read_system_info();
        let stored_version = system_info.get_stable_memory_version();

        if stored_version == STABLE_MEMORY_VERSION {
            // Run the post-run checks that need to be run on every upgrade.
            post_run();
            return;
        }

        if stored_version > STABLE_MEMORY_VERSION {
            trap(&format!(
                "Cannot downgrade the station from memory layout version {stored_version} to {STABLE_MEMORY_VERSION}"
            ));
        }

        if stored_version != STABLE_MEMORY_VERSION - 1 {
            trap(&format!(
                "Cannot skip upgrades between station memory layout version {stored_version} to {STABLE_MEMORY_VERSION}"
            ));
        }

        apply_migration();

        // Update the stable memory version to the latest version.
        system_info.set_stable_memory_version(STABLE_MEMORY_VERSION);
        write_system_info(system_info);

        // Run the post-run checks that need to be run on every upgrade.
        post_run();
    }
}

/// If there is a check that needs to be run on every upgrade, regardless if the memory version has changed,