Loading…
.jpg&w=3840&q=75)
← Handboek
Runbooks
'n Stelsel is nie klaar wanneer dit werk nie — dit is klaar wanneer iemand anders dit kan bedryf wanneer dit breek. Elke bou word gelewer met runbooks: ontplooi, terugrol, insidentreaksie en 'n oorhandiging in gewone taal. Hieronder is 'n werklike, verkorte voorbeeld uit 'n produksie-literêre platform.
.jpg&w=3840&q=75)
Van nul tot produksie
'n Afhanklikheid-geordende ontplooiing
Georden omdat volgorde saak maak — saadgebruikers bestaan voordat die saadmigrasie loop, omgewingsveranderlikes bestaan voordat die eerste ontplooiing plaasvind, die werf-URL word gestel voordat DNS oorgeskakel word.
- 1
Voorsien data
Skep die Supabase-projek in af-south-1 (Kaapstad); skep die auth-gebruikers voor die saadmigrasie sodat profiel-/storiesade volgens UUID oplos; voer migrasies streng in volgorde uit; bevestig dat stoorbakke korrek opgestel is.
- 2
Bedraad dienste
Verifieer die e-posdomein (SPF / DMARC / DKIM), verkry 'n langlewende sosiale toegangstoken, en skep die AI-sleutel — elkeen met sy eie kontrolelys.
- 3
Konfigureer & ontplooi
Voeg elke omgewingsveranderlike by voor die eerste ontplooiing (nooit daarna nie); ontplooi; stel die kanonieke werf-URL en herontplooi sodat auth-skakels oplos.
- 4
DNS
Wys die apex- en www-rekords, verifieer dan die werf-URL weer sodat wagwoordherstel- en OAuth-skakels oor toestelle heen veilig is.
- 5
Rooktoets
Voer 'n vaste kontrolelys uit na elke ontplooiing: tuisblad + omslag verbeeld, podcast-blad, AI-assistent reageer, admin-aanmelding + rol-herleiding, konsep stoor, redaksionele oorhandiging, 'n toets-nuusbrief-stuur (onder 2 min), en 'n beeldoplaai.
.jpg&w=3840&q=75)
Wanneer iets breek
Operasionele prosedures
Herstel 'n gebruiker se wagwoord
Drie gedokumenteerde paaie — selfdiens-e-pos, paneelbord-geaktiveerde herstel, en 'n nood-dwangstelling.
Ontpubliseer / sagte-skrap / herstel
Skuif 'n storie uit "gepubliseer" (binne ~60s publiek weg), sagte-skrap met deleted_at, of herstel deur dit skoon te maak — nooit 'n harde skrap nie.
Nuusbrief-stuur-mislukking
Kontroleer verskafferlogboeke vir terugkaatsings/tariefgrense, kruisverwys aktiewe intekenaars, probeer weer per ontvanger, en merk harde terugkaatsings as uitgeteken.
Sosiale-plasing-mislukking
'n Foutkode-kaart (verstreke token / toestemmings / inhoudvlag) plus 'n token-rotasie-runbook: hergenereer, verleng, werk die omgewingsveranderlike by, herontplooi.
Diagnoseer 'n RLS-fout
Inspekteer die beleid via pg_policies, onderskei die RLS-gebonde kliënt van die diens-kliënt, en toets deur rolle te wissel.
Rol 'n ontplooiing terug
Lees die bou-logboeke; rol terug deur die vorige goeie ontplooiing tot produksie te bevorder; herontplooi om omgewingsveranderinge op te tel.
.jpg&w=3840&q=75)
Die oorhandiging
Jy besit dit — en jy kan dit bedryf.
Lewering sluit 'n oorhandiging-kontrolelys in wat in gewone taal geskryf is — wat elke oorblywende instelling doen, wat 'n webhook "in gewone woorde" is, en 'n probleemoplossingsgids vir die paar stappe wat net op die paneelbord gedoen word. Die kode, die skema, die runbooks en die data is joune. Dit is die antwoord op die vraag wat elke ernstige koper oor 'n klein studio vra: wat gebeur wanneer jy nie beskikbaar is nie? Die stelsel is goed genoeg gedokumenteer dat die antwoord is "jy, of enigiemand wat jy huur, kan aanhou."
