Expand description
Pure credential/volume metadata over the CRD types: which Secrets a
repository’s mover needs. Shared by the controller (envFrom projection,
referent watches) and external tooling (kubectl kopiur doctor), so the
“what credentials does this backend reference” answer cannot fork.
Structs§
- Creds
Secret Ref - A credential Secret a mover Job needs, with the namespace it is sourced from.
namespaceis the resolved source namespace (where the operator reads the Secret when projecting), not the Job’s namespace.Noneonly when neither the reference nor the repository carries one — which projection treats as an actionable error (aClusterRepositoryreference must pin a namespace).
Enums§
- Workload
Identity Cloud - Which cloud IAM plane a workload-identity backend federates with. Drives the cloud-specific mover wiring (the Azure pod label; docs/messages naming the right SA annotation).
Constants§
- DEST_
ENV_ PREFIX - Env-var prefix under which a replication mover receives the destination
backend’s credential Secret (
envFrom.prefix). The source backend’s Secret is delivered unprefixed (kopia reads the plain names atrepository connectand persists them), so the two sides never collide even when both are the same backend family with different keys (issue #200). The mover reads these back to authenticate thekopia repository sync-todestination. - DEST_
KOPIA_ PASSWORD_ ENV - Env var carrying the destination repository’s encryption password
(
KOPIA_PASSWORD) into a snapshot-replication mover. The source password rides the plainKOPIA_PASSWORD(persisted into the source kopia config at connect), so the destination’s must arrive under a distinct name — the mover reads this and re-exports it asKOPIA_PASSWORDfor the destination client only. Deliberately NOT{DEST_ENV_PREFIX}KOPIA_PASSWORDmechanical prefixing: the controller delivers it as a singlevalueFrom.secretKeyRefenv var built from the RESOLVED destination credentials (which may be a projected copy with a different Secret name), not via anenvFromprefix remap. - MAX_
CREDS_ IDX - The highest per-repository credential-Secret index
mover_creds_secret_refscan ever yield: the encryption-password Secret (idx 0) plus, only when it is differently named, the backend’s auth Secret (idx 1). Every consumer that derives per-index resource names (projected copies, server mirrors) bounds its reap walks with this. - SEED_
ENV_ PREFIX - Env-var prefix under which a seeding bootstrap mover receives the seed
SOURCE’s credential Secret (
envFrom.prefix), the mirror image ofDEST_ENV_PREFIX. - SEED_
KOPIA_ PASSWORD_ ENV - Env var carrying the seed SOURCE repository’s encryption password into a
seeding bootstrap mover, the mirror image of
DEST_KOPIA_PASSWORD_ENV.
Functions§
- backend_
auth_ secret_ ref - The backend credentials Secret name for an object-store backend, if any.
- backend_
workload_ identity - The backend’s workload-identity binding, if any, with its cloud plane.
- mover_
creds_ secret_ refs - The distinct credential Secrets a mover Job for
backend+encryptionneeds asenvFrom, each with its resolved source namespace: always the encryption-password Secret, plus the backendauthSecret when present and differently named. Deduped by name, order-stable (password first). - mover_
creds_ secrets - The distinct credential Secret names a mover Job for
backend+encryptionneeds asenvFrom: always the encryption-password Secret, plus the backendauthSecret when present and different. Deduped, order-stable (password first). The common single-secret setup (password + keys in one Secret) collapses to one entry. Names-only projection ofmover_creds_secret_refs.