Enum Request 

pub enum Request {
    Add(AddRequest),
    Remove(RemoveRequest),
    Configure(ConfigureRequest),
    Lifecycle(LifecycleRequest),
    Upgrade(UpgradeRequest),
    List,
    Get {
        service: String,
    },
    Diff {
        service: String,
    },
    Backups {
        service: String,
    },
    Revert {
        service: String,
        at: Option<String>,
    },
    Search {
        query: Option<String>,
        registry: Option<String>,
    },
    Registries,
    AddRegistry {
        name: String,
        url: String,
    },
    RemoveRegistry {
        name: String,
    },
    Doctor,
    Backup {
        service: String,
    },
    Restore {
        service: String,
        snapshot: String,
    },
    Snapshots {
        service: String,
    },
    BackupStatus,
    ConfigureBackup {
        backend: BackupBackendSpec,
        password: Option<String>,
    },
    SetBackupEnrolled {
        service: String,
        enabled: bool,
    },
    ServiceDef {
        service: String,
        registry: Option<String>,
    },
    ConfigureView {
        service: String,
    },
    Reconcile {
        services: Vec<String>,
        dry_run: bool,
    },
}

One request to the agent. Adjacently tagged so it maps straight onto a JSON-RPC method + params: {"method":"add","params":{...}}, {"method":"list"}.

Variants

Add(AddRequest)

Install and start a service.

Remove(RemoveRequest)

Remove a service (optionally purging its data).

Configure(ConfigureRequest)

Re-render an installed service with a changed integration set.

Lifecycle(LifecycleRequest)

Start or stop an installed service.

Upgrade(UpgradeRequest)

Upgrade an installed service to the registry’s current version.

List

List every service (installed + orphan) with live status.

Get

One service’s current view.

Fields

service: String

Diff

What an upgrade would change for a service (read-only).

Fields

service: String

Backups

The pre-upgrade snapshots available to revert to, newest first.

Fields

service: String

Revert

Restore a service from a pre-upgrade snapshot (latest if at is None).

Fields

service: String

at: Option<String>

Search

Search a registry for installable services (default registry if unset).

Fields

query: Option<String>

registry: Option<String>

Registries

List the configured registries.

AddRegistry

Add a custom registry.

Fields

name: String

url: String

RemoveRegistry

Remove a custom registry.

Fields

name: String

Doctor

Run the diagnostics ryra-doctor runs.

Backup

Take a backup snapshot of a (backup-enabled) service.

Fields

service: String

Restore

Restore a service’s data from a restic snapshot (“latest” for newest).

Fields

service: String

snapshot: String

Snapshots

List a service’s restic data snapshots, newest first (ryra backup list).

Fields

service: String

BackupStatus

The effective backup configuration + enrolled services (ryra backup status).

ConfigureBackup

Point backups at a backend: init the restic repo and persist [backup] (ryra backup configure). password is the restic key; when absent the engine reuses the existing key or generates a fresh one.

Fields

backend: BackupBackendSpec

password: Option<String>

SetBackupEnrolled

Opt a service in or out of backups.

Fields

service: String

enabled: bool

ServiceDef

The installable env/group/choice schema for a registry service (default registry if registry is unset).

Fields

service: String

registry: Option<String>

ConfigureView

The configure view (schema + current selections + .env) for an installed service.

Fields

service: String

Reconcile

Propagate the current global config into installed services (ryra configure --apply). Empty services = every installed service whose env would change; dry_run previews without writing/restarting.

Fields

services: Vec<String>

dry_run: bool

Trait Implementations

impl Clone for Request

fn clone(&self) -> Request

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Request

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Request

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Request

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.