Module repository 

The Repository CRD — a namespaced kopia repository. ADR-0003 §3.1.

Structs

BootstrapSpec

Tuning for the bootstrap/discovery mover Job, shared by Repository and ClusterRepository. Bootstrap connects (or, with create, creates) an object-store repository the operator cannot reach in-process.

CatalogStatus

Status of catalog materialization for origin: discovered Snapshot CRs.

EpochParameters

kopia epoch-manager parameters. Absent fields are left at whatever the repository already has (kopia’s defaults, noted per field).

ObservedBlobRetention

The blob retention the repository ACTUALLY reports, mirrored into status from kopia repository status at the last bootstrap.

ObservedEpochParameters

The epoch parameters the repository ACTUALLY reports, mirrored into status from kopia repository status at the last bootstrap.

ObservedRepositoryParameters

Observed kopia repository parameters, mirrored into status.

Repository

Auto-generated derived type for RepositorySpec via CustomResource

RepositoryHealthProbeSpec

Backend health probe, shared by Repository and ClusterRepository. On by default.

RepositoryHealthSpec

Repository health thresholds, shared by Repository and ClusterRepository.

RepositoryHealthStatus

Backend health-probe state, shared by Repository and ClusterRepository. Pinned by the reconciler when spec.health.probe is enabled so the next reconcile can tell whether a probe is due and how many consecutive failures have accrued (the debounce that keeps a transient blip from raising the loud RepositoryVanished / BackendReachable=False condition).

RepositoryParameters

Mutable kopia repository parameters (kopia repository set-parameters), shared by Repository and ClusterRepository.

RepositorySpec

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

RepositoryStatus

Observed state of a Repository, carrying resolved values pinned by the reconciler.

RetentionWindow

How long a blob stays locked once written.

StorageStats

Aggregate repository storage figures from the last catalog scan.

Enums

BlobRetention

Object-lock blob retention (kopia repository set-parameters --retention-mode/--retention-period).

ProbeOnFailure

What sustained backend-probe failure (past failureThreshold) does to the repository (default Degrade). Degrade moves it to Degraded, pausing backups and replication until a re-connect succeeds — recovery is automatic (maintenance also pauses for a confirmed-unreachable/vanished backend, but keeps running for a probe deadline kill, where index compaction is often the cure). Alert keeps the repository Ready and only raises the BackendReachable condition + Warning event + metric; backups keep running against the failing backend. Neither ever auto-recreates.

RepositoryPhase

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

Functions

resolve_index_blob_warn_threshold

Resolve the effective index-blob warning threshold from an optional spec.health. Pure, so it’s shared by the admission webhook, the controller, and tests without forking the default/disable semantics: