Enum Step 

pub enum Step {
    FlipConfigToDatabaseMode {
        config_yaml: String,
    },
    PushCarriedPolicy {
        hujson: String,
    },
    RemoveAclsFile,
    Done,
    Blocked {
        reason: String,
    },
}

The one action to take next. Re-derive it after every step; never queue a batch, because each step changes what the correct next one is.

Variants

FlipConfigToDatabaseMode

Write config_yaml back and restart headscale. Carries the rewritten config so the caller never has to re-derive it.

Fields

config_yaml: String

PushCarriedPolicy

PUT /api/v1/policy with this document. Only reachable once the coordinator is in database mode.

Fields

hujson: String

RemoveAclsFile

The coordinator serves the carried policy from its database. The file is now genuinely redundant and can go.

Done

Migrated. Re-running from here changes nothing.

Blocked

The coordinator is in a state this migration refuses to guess at.

Fields

reason: String

Implementations

impl Step

pub fn label(&self) -> String

A one-line name for the step, for plans and progress output.

Step’s Debug embeds a whole config.yaml or policy document, which is right for a failure message and unreadable in a list of steps.

pub fn on_box_commands( &self, headscale_dir: &str, supervisor: &Supervisor, ) -> Vec<String>

Shell the operator (or a gated rail) runs on the box for the steps that are not API calls. Empty for Step::PushCarriedPolicy, which is driven through apply_push, and for the terminal states.

The restart line depends on supervisor and there is no safe default — see Supervisor for why emitting systemctl restart against a kamaji-supervised coordinator is worse than emitting nothing.

Trait Implementations

impl Clone for Step

fn clone(&self) -> Step

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Step

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Step

impl PartialEq for Step

fn eq(&self, other: &Step) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Step