Runbook

Vad det är

En runbook är en testad instruktion för en driftuppgift. Den
beskriver när uppgiften ska utföras, vilka förutsättningar den
kräver, hur den utförs och hur man känner igen resultatet.
Operatören kan följa stegen själv. Instruktionen kan också förklara
ett automatiserat förfarande och vilka kontroller det gör. Uppgiften
kan vara att förnya ett certifikat, prova att återställa en
säkerhetskopia eller gå tillbaka till en känd konfiguration.

AWS rekommenderar runbooks för återkommande driftuppgifter och
playbooks för undersökning av problem. Orden används på olika sätt
av olika grupper. Se vad läsaren behöver veta när instruktionen
öppnas. Om uppgiften är känd kan stegen föra från ett visst
utgångsläge till ett definierat resultat. Om orsaken eller den rätta
åtgärden är okänd behöver instruktionen ange vilka observationer som
leder till nästa beslut.

Instruktionen kan vara kort. Den behöver ange system, miljö,
behörighet, ansvarig person, nödvändiga kontroller och hur man vet
att det är klart. Den anger också när operatören ska avbryta och vem
som kan hjälpa till. Att ett verktyg rapporterar att det är färdigt
och att tjänsten fungerar för användarna är olika saker. Varje steg
ska kunna bedömas med de iakttagelser som hör dit.

Varför det spelar roll

Mitt under ett avbrott kan personen som svarar känna tjänsten och
ändå sakna erfarenhet av verktyget för återställning. En användbar
instruktion sparar arbetet med att rekonstruera tillvägagångssättet
ur minnet. Läsaren kan kontrollera att rätt system och rätt data är
valda och kan se vad som behöver ha hänt innan nästa steg. Detta är
särskilt viktigt när jouren byts eller när flera avdelningar måste
bidra.

Arbetet med att skriva instruktionen gör också dolda förutsättningar
synliga. En kollega kan anse att kopian är klar när ett jobb har
körts färdigt. Den som övar kan upptäcka att nästa verktyg kräver
ytterligare en behörighet eller att rapporten utelämnar rader som
inte gick att kopiera. En instruktion gör sådana skillnader tydliga.
Teamet kan sedan avgöra vilka delar som kan automatiseras och vilka
beslut en person fortfarande måste fatta.

Uppdatera instruktionen när en förutsättning ändras. En namngiven
ägare kan hålla texten nära den kod eller konfiguration som styr
uppgiften och ändra dem tillsammans när det behövs. En övning med en
annan person kan fånga antaganden som författaren själv tar för
givna. Teamet kan också pröva hur operatören hittar instruktionen om
den vanliga dokumenttjänsten eller inloggningen är nere.

Så ser det ut i praktiken

Tänk dig en rutin som ska visa att en säkerhetskopia av en
rapportdatabas går att återställa. Instruktionen anger databasens
namn, en isolerad miljö och kontot med behörighet att läsa kopian
och skapa testdatabasen. Den ber operatören kontrollera kopians
ursprung och ålder och bekräfta att inget system i skarp drift
använder testmiljön. Operatören skriver ned vilken kopia som valts
och när återställningen började.

Nästa steg anger vilket verktyg som används och var resultatet
loggas. Efter återställningen kör operatören en känd rapport, jämför
några förväntade värden och tittar på datumet för den nyaste posten.
Om värden saknas, källan är fel eller rapporten inte fungerar ska
operatören pausa och kontakta den som står i vägledningen. Efter en
lyckad övning skriver teamet ned tiden och tar bort den tillfälliga
kopian och övningens särskilda åtkomst enligt planen.

Låt sedan en kollega pröva instruktionen med en kopia som avsiktligt
är äldre än tidsgränsen för övningen. Skillnaden ska synas innan
återställningen startar. Kollegan ska veta vilken uppgift som
behöver sparas och var den ska rapporteras. Ägaren rättar oklara
steg efter övningen. Den uppmätta tiden visar vad som hände under de
villkor som verkligen provades.

Engineers fall om säkerhetskopior som faktiskt har återställts visar
ett dokumenterat arbete med återställningsprov. En lyckad kopiering
ger inget besked om hur användbar den återställda databasen är.
Rapportdatabasen ovan är ett tänkt exempel på en instruktion med
resultat och gränser som andra kan pröva.

Anteckna även vad som kan delas efter övningen utan att kopiera
personuppgifter eller hemliga värden. En kort rapport kan ange
miljön, vilka kontroller som kördes och vilken händelse som startade
tidtagningen. Om säkerhetskopian gick att läsa men rapporten saknade
de senaste raderna, hör båda observationerna hemma i rapporten.
Teamet behöver den skillnaden när det väljer nästa kopia eller
ändrar gränsen för när instruktionen ska avbrytas.

Var det går fel

Stegen förutsätter att allt annat fungerar. Om den vanliga
inloggningen eller övervakningen är nere får teamet inte tappa den
godkända vägen till instruktionen och dess kontroller. Repetera hur
rätt person hittar dem.

Instruktionen säger vad man ska klicka på. Ett ändrat gränssnitt kan
snabbt göra en bild inaktuell. Beskriv vad åtgärden påverkar, vilket
resultat som väntas och vilka avvikelser som ska avbryta den.

Samma instruktion används för alla symptom. Många fel kan se
likadana ut. Samla observationer så att den nödvändiga uppgiften är
identifierad innan stegen följs.

Bara författaren har testat den. Låt en kollega arbeta i en säker
miljö. Be den personen notera var en förkortning, en behörighet
eller ett resultat måste gissas för att komma vidare.

Läs mer

  * AWS om runbooks — förberedda instruktioner, ansvar och
underhåll.

  * AWS om playbooks — hur observationer leder till rätt åtgärd.

  * Googles erfarenheter av akuta incidenter — att öva i förväg och
lära av tidigare händelser.

hDen här sidan på webben	URL:https://engineer.company/sv/glossary/runbook/	engineer.company	70
