Struct Source 

pub struct Source {
    pub pvc: Option<PvcSource>,
    pub pvc_selector: Option<PvcSelector>,
    pub nfs: Option<NfsVolume>,
    pub stream: Option<StreamSource>,
    pub read_only: Option<bool>,
    pub acknowledge_live_mutation: Option<bool>,
    pub source_path_override: Option<String>,
    pub source_path_strategy: Option<SourcePathStrategy>,
}

A single backup source; exactly one of pvc, pvcSelector, nfs, stream (webhook-enforced).

Fields

pvc: Option<PvcSource>

Single PVC by name. Mutually exclusive with pvcSelector/nfs.

pvc_selector: Option<PvcSelector>

Label/namespace selector matching many PVCs. Mutually exclusive with pvc/nfs.

nfs: Option<NfsVolume>

An inline NFS export to back up directly. Mutually exclusive with pvc/pvcSelector/stream.

stream: Option<StreamSource>

Capture a command’s standard output as one virtual file — a logical backup (pg_dumpall, mysqldump, …) rather than a volume copy. Mutually exclusive with pvc/pvcSelector/nfs. No volume is mounted; the mover execs the command in a running workload Pod and streams its stdout straight into kopia.

read_only: Option<bool>

Mount the source read-only (default true; kopia only ever reads it).

Set false only to make fsGroup work on the source. The kubelet applies fsGroup by recursively chgrp-ing the volume and adding group-write — and it skips that walk entirely on a read-only mount, which is why a mover fsGroup/fsGroupChangePolicy otherwise has no effect here. Under copyMethod: Snapshot/Clone the walk rewrites the throwaway staged PVC and never touches your data. Under copyMethod: Direct it rewrites the LIVE volume, which requires acknowledgeLiveMutation.

Not supported on an nfs source: the kubelet does not apply fsGroup to in-tree NFS volumes at all, so a read-write mount would grant nothing.

acknowledge_live_mutation: Option<bool>

Acknowledges that copyMethod: Direct + readOnly: false lets the kubelet recursively chgrp the live volume to the mover’s fsGroup and make it group-writable — permanently, while the workload is running. Required for that combination alone.

Ignored (not rejected) otherwise: it is an acknowledgement, never harmful to carry, and rejecting a stale one would make switching copyMethod between Direct and Snapshot/Clone a two-step edit in both directions.

source_path_override: Option<String>

What kopia records as the source path (default /pvc/<name>, or the NFS export path).

On a pvcSelector source this is a footgun. It is ONE literal path, so it works only while the selector matches exactly one PVC; the moment a second PVC matches, both would land on that same kopia source, merging their histories into one stream where they also prune each other, so the BACKUP is refused at run time and no further snapshots are minted for that source.

Watch the failed schedule fire, not verification: the earlier snapshots remain at that path, so verification keeps passing while backups have stopped. (Verification only fails on a path that never received a backup.) Prefer sourcePathStrategy, which derives a distinct path per PVC, or put the override on its own pvc: source.

source_path_strategy: Option<SourcePathStrategy>

How a pvcSelector-matched PVC’s source path is derived (pvcName vs pvcNamespacedName).

Trait Implementations

impl Clone for Source

fn clone(&self) -> Source

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Source

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

Formats the value using the given formatter.

impl Default for Source

fn default() -> Source

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Source

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for Source

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 Source

fn eq(&self, other: &Source) -> 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 Source

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 Source