Struct RepositorySpec 

pub struct RepositorySpec {

    pub backend: Backend,
    pub encryption: Encryption,
    pub create: Option<CreateBehavior>,
    pub seed: Option<SeedSpec>,
    pub bootstrap: Option<BootstrapSpec>,
    pub mover_defaults: Option<MoverDefaults>,
    pub schedule_defaults: Option<ScheduleDefaults>,
    pub catalog: Option<CatalogBounds>,
    pub identity_defaults: Option<IdentityDefaults>,
    pub server: Option<ServerSpec>,
    pub maintenance: Option<RepositoryMaintenanceSpec>,
    pub on_namespace_delete: NamespaceDeletePolicy,
    pub deletion_protection: Option<DeletionProtectionSpec>,
    pub concurrency: Option<ConcurrencySpec>,
    pub mode: RepositoryMode,
    pub suspend: bool,
    pub health: Option<RepositoryHealthSpec>,
    pub parameters: Option<RepositoryParameters>,
}

A kopia repository owned by one namespace, referenced by SnapshotPolicys and Restores.

Fields

backend: Backend

Exactly one storage backend.

encryption: Encryption

Repository password (a Secret reference).

create: Option<CreateBehavior>

What to do when the repository does not yet exist (absent means it must already exist).

seed: Option<SeedSpec>

Initialize this repository from an existing replica on its FIRST bootstrap (issue #380) — a disaster-recovery entry point.

Armed only while the repository has never been initialized (status.uniqueId unset) and the mover’s connect reports the backend uninitialized; on an already-initialized repository it is a documented no-op (Seeded=True, reason AlreadyInitialized), so it is safe to leave standing in a GitOps manifest. When armed it also replaces spec.create’s fallback: the repository is seeded or the bootstrap fails, never silently created empty.

bootstrap: Option<BootstrapSpec>

Tuning for the bootstrap/discovery mover Job (<name>-discovery) that connects/creates an object-store repository the operator cannot reach in-process (and re-runs for catalog re-scans).

mover_defaults: Option<MoverDefaults>

Base mover configuration inherited by every mover this repository spawns.

schedule_defaults: Option<ScheduleDefaults>

Scheduling defaults (timezone, jitter) inherited by consumers that don’t set their own equivalent field — backup, verification, replication, and maintenance schedules; set once here instead of repeating it on every cron.

catalog: Option<CatalogBounds>

Bounds materialization of origin: discovered Snapshot CRs from the kopia catalog.

identity_defaults: Option<IdentityDefaults>

Identity defaults (CEL *Expr) applied when consumers don’t override. Set cluster when this repository’s backend is shared across clusters (e.g. one bucket backed up from more than one Kubernetes cluster) — the default kopia identity hostname then becomes <namespace>.<cluster> instead of bare <namespace>, so same-named namespaces on different clusters never collide. Same semantics as ClusterRepository’s field of the same name (ADR-0004 §5); a consumer’s explicit spec.identity still wins over anything here.

server: Option<ServerSpec>

Optional kopia web-UI server, exposed via a Service in this namespace.

maintenance: Option<RepositoryMaintenanceSpec>

Maintenance control; when absent or enabled the reconciler creates and owns a Maintenance CR.

on_namespace_delete: NamespaceDeletePolicy

What happens to this repository’s snapshots when a consuming namespace is deleted.

deletion_protection: Option<DeletionProtectionSpec>

Mass-deletion circuit breaker for this repository’s Snapshots.

concurrency: Option<ConcurrencySpec>

Concurrency limits for mover Jobs against this repository (absent = unlimited).

mode: RepositoryMode

Access mode: ReadWrite (default) or ReadOnly (serves restores only).

suspend: bool

Pause this repository: skip connect/bootstrap and maintenance projection.

health: Option<RepositoryHealthSpec>

Repository health thresholds (tunes the index-blob-count warning).

parameters: Option<RepositoryParameters>

Mutable kopia repository parameters, re-applied on bootstrap whenever they drift.

Trait Implementations

impl Clone for RepositorySpec

fn clone(&self) -> RepositorySpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RepositorySpec

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RepositorySpec

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for RepositorySpec

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for RepositorySpec

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for RepositorySpec

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RepositorySpec