Enum RepositoryPhase 

pub enum RepositoryPhase {
    Pending,
    Initializing,
    Ready,
    Degraded,
    Failed,
    Unknown(String),
}

Lifecycle phase of a repository. A freshly admitted CR starts in Pending.

use kopiur_api::repository::RepositoryPhase;

assert_eq!(serde_json::to_value(RepositoryPhase::Ready).unwrap(), "Ready");
// An unrecognized phase from a newer operator decodes instead of erroring.
let p: RepositoryPhase = serde_json::from_value(serde_json::json!("Upgrading")).unwrap();
assert_eq!(p, RepositoryPhase::Unknown("Upgrading".into()));
assert_eq!(serde_json::to_value(&p).unwrap(), "Upgrading");

Variants

Pending

Accepted by the API server but not yet reconciled.

Initializing

Connecting to (or creating) the kopia repository.

Ready

Connected and healthy.

Degraded

Temporarily not fully operational, and self-healing: a retryable bootstrap/connect failure is being retried, or the backend health probe exceeded its failureThreshold (the circuit breaker is open — backups and replication are paused until a re-connect succeeds; maintenance still runs for an already-bootstrapped repository unless the backend is confirmed unreachable or the repository vanished, because index compaction is often the cure). See the BackendReachable and Ready conditions for the cause.

Failed

Connect/create failed; see conditions for the actionable reason.

Unknown(String)

A phase string this build does not recognize (newer operator, or legacy stored data). Decode-compat only — hidden from the CRD schema, never produced by this build. Never treated as Ready: consumers that gate on “is the repository usable” must hold, not proceed.

Trait Implementations

impl Clone for RepositoryPhase

fn clone(&self) -> RepositoryPhase

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RepositoryPhase

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

Formats the value using the given formatter.

impl Default for RepositoryPhase

fn default() -> RepositoryPhase

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RepositoryPhase

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Eq for RepositoryPhase

impl JsonSchema for RepositoryPhase

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

The name of the generated JSON Schema.

fn json_schema(_: &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.

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

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

impl PartialEq for RepositoryPhase

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

const ALL: &'static [Self]

Every canonical variant, in declaration order. Never contains Unknown.

fn label(&self) -> &str

The stable metric/wire label string for this variant (exhaustive match); the Unknown arm echoes the stored value verbatim so a read-modify-write never mutates a phase this build does not understand.

fn unknown(raw: String) -> Self

Build the decode-compat fallback for a non-canonical stored string. Implemented by the phase_serde! macro’s host enum.

fn parse(s: &str) -> Option<Self>

Parse a canonical label; None for anything else (including a value that would decode to Unknown). Derived from ALL + label() so a new variant is parseable the moment it is declared.

fn canonical() -> Vec<&'static str>

The canonical label set, for the CRD schema enum and “valid values” messages. One definition, derived from ALL.

impl Serialize for RepositoryPhase

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RepositoryPhase