Dokumenter i objektlagring
This content is not available in your language yet.
Bilagsvedlegg, innboksdokumenter, kvitteringer på utlegg, mottatt e-post
(rå melding og vedlegg) og vedlegg til balansedokumentasjon lagres i en
S3-kompatibel objektlagring, ikke i databasen (migrasjon 0070, 2026-11-08).
Databasen beholder raden — metadata, hvem, når, og dokumentets SHA-256 —
mens selve bytene ligger i lagringen under nøkkelen
<prefiks><sha256 i hex>.
Hvorfor
Section titled “Hvorfor”Dokumentene er det som vokser: bilder og PDF-er er hundrevis av ganger
større enn posteringene. I databasen gjorde de hver nattlige pg_dump,
hver ukentlig gjenopprettingsøvelse og hver vacuum tregere i takt med
kundemassen, og de fylte diskene på databaseboksene. Objektlagringen er
laget for nettopp dette.
Garantien er den samme som før
Section titled “Garantien er den samme som før”- Hashen sjekkes ved hver lesing. Bytene hentes fra raden hvis den fortsatt har dem, ellers fra lagringen, og SHA-256 sammenlignes med hashen i raden før noe leveres. Et endret objekt avvises som endrede byte i databasen ble.
- Et manglende objekt er en feil, aldri et tomt dokument.
verify-ledgerog revisjonsrapportens kontroll av vedlegg leser hvert dokument og feiler høylytt hvis et objekt er borte. - Innholdsadressert. Samme byte er ett objekt uansett hvor mange rader som peker på det: et innboksdokument som bokføres blir et bilagsvedlegg uten at noe kopieres, og en ny opplasting av samme fil skriver over seg selv med identiske byte.
- Objektet skrives før raden. En rad peker aldri på et objekt som ikke finnes; feiler transaksjonen etterpå, blir det bare liggende et objekt ingen rad peker på.
Flytting av eksisterende dokumenter
Section titled “Flytting av eksisterende dokumenter”regnmed offload-documents går gjennom alle seks kolonnene: skriver
bytene til lagringen, leser dem tilbake og sammenligner, og tømmer først
da radens innholdskolonne. Kommandoen kan kjøres på nytt og avbrytes;
en rad er enten urørt eller beviselig i lagringen.
Tabellene er fortsatt bare-innsetting. Migrasjon 0070 gir vaktene ett
unntak, samme form som faktureringsmerket på timer: innholdskolonnen kan
gå fra byte til NULL, forutsatt at alle andre kolonner er uendret og at
den lagrede hashen ER hashen av bytene som fjernes (for rå e-post, som
manglet hash, settes den i samme oppdatering). Innholdet kan aldri komme
tilbake eller byttes ut. Testen
an_attachment_row_allows_only_a_verified_offload (regnmed-db) fester det.
Konfigurasjon
Section titled “Konfigurasjon”Seks variabler, alle eller ingen (regnmed-db::blob):
BLOB_S3_ENDPOINT, BLOB_S3_BUCKET, BLOB_S3_REGION, BLOB_S3_PREFIX,
BLOB_S3_ACCESS_KEY, BLOB_S3_SECRET_KEY. Uten dem lagres dokumentene i
databasen som før (lokal utvikling, CI). En halv konfigurasjon nektes ved
oppstart. I clusterne kommer de fra Secret-en blob-store
(valgfri envFrom på alle regnmed-containere, docs/deploy.md).
| Miljø | Bøtte | Prefiks |
|---|---|---|
| prod (Hetzner) | bogenhuset (hel1) |
regnmed-prod/documents/ |
| test (homelab) | bogenhuset (hel1) |
regnmed-test/documents/ |
S3-klienten er håndskrevet (PUT og GET med AWS Signature V4 over sha2 og
reqwest), testet mot AWS’ publiserte eksempelsignatur og mot Hetzner. Den
prøver på nytt (fem forsøk, økende pause) ved tidsavbrudd, 429 og 5xx —
Hetzner svarte sporadisk 504 for et objekt som fantes, og første
verify-ledger i prod feilet på det (2026-11-08). En 404 prøves ikke på
nytt: da er objektet borte, og det meldes som det.
Hetzner holder også en og annen GET i mange sekunder før den svarer: av 65 vedlegg i prods revisjonsrapport kom 62 straks, mens tre små (15–54 KB) ventet 2,6, 5,5 og 17 s på svarhodene (2026-11-09, målt etter at nett og DNS var utelukket). Stoppet hører til OBJEKTET, ikke forsøket: v0.8.3 forlot en GET uten svarhoder etter 3 s og sendte den på nytt, og møtte samme stopp fem ganger på rad — revisjonsrapporten meldte da et vedlegg som feilet som ikke var endret, bare tregt. Rullet tilbake i v0.8.4: hvert forsøk venter klientens 30 s. Hvert feilet forsøk, og hvert vellykket som tok over 2 s, logges med tidene sine, og revisjonsrapporten viser hele feilkjeden, så «utilgjengelig» og «endret» aldri leses likt.
Versjonering
Section titled “Versjonering”Hashen avslører et endret eller slettet objekt, men gjenoppretter det
ikke. Derfor har bogenhuset versjonering slått på (2026-11-09): et
overskrevet eller slettet objekt blir liggende som en eldre versjon og kan
hentes tilbake med versionId. Versjonering gjelder hele bøtta og kan bare
settes på pause, aldri slås helt av.
Livssyklusreglene holder lagringen innenfor det fastprisen dekker, fordi backupverktøyene i samme bøtte sletter gamle data hver dag:
| Prefiks | Eldre versjoner beholdes |
|---|---|
regnmed-prod/ |
30 dager |
regnmed-test/ |
7 dager |
backupstore/ (Longhorn), cnpg/ (Postgres-backup) |
1 dag |
Ufullførte opplastinger fjernes etter 2 dager. Dokumentene skrives aldri
over og slettes aldri (innholdsadressert), så de 30 dagene koster bare
plass hvis noe har gått galt — og det er vinduet for å oppdage og rette
det. Den ukentlige gjenopprettingskontrollen (backup-verify, søndag 04:00)
kjører verify-ledger, som leser hvert dokument fra bøtta — et
forsvunnet objekt meldes altså innen en uke, godt før versjonen utløper.
Ikke gjort ennå
Section titled “Ikke gjort ennå”- Object lock (WORM). Versjonering beskytter mot uhell, ikke mot en som har bøttenøkkelen og sletter versjonene også. Object lock må slås på når bøtta opprettes, og krever derfor en ny bøtte.
payment_run.file(noen kB pain.001-XML på en kjøringsrad som endres gjennom statusene) ligger fortsatt i databasen.