Skip to content

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>.

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.

  • 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-ledger og 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å.

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.

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.

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.

  • 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.