Fitimet:
- Aftësia për të prodhuar skelet dokumentesh, pas vdekjes dhe arkitektonike nga shënime të shpërndara me inteligjencë artificiale
- Aftësia për të zbatuar disiplinën e vendosjes së një 'ndalimi të fabrikimit' dhe testimit dhe shënimit të plotë të çdo libri në një mjedis real
- Aftësia për të kuptuar se një manual i gabuar është më i rrezikshëm se asnjë dhe për të mbajtur dokumentacionin gjallë gjatë procesit të ndryshimit
Menaxhimi i Dokumentacionit dhe Informacionit: Runbook, Arkitektura dhe Kujtesa Institucionale me AI
Detyra më e lënë pas dore, por që shpëton jetë e menaxhimit të sistemit është dokumentimi. Kur një sistem rrëzohet dhe personi që e ka ndërtuar është me pushime dhe nuk ka asnjë fjalë të shkruar se si të shërohet, është një natë e gjatë për të gjithë. Dokumentacioni është memoria institucionale që bën të shkruar dhe të disponueshme se si është ngritur një sistem, si funksionon dhe çfarë duhet bërë nëse shfaqet një problem. Lloji më kritik i kësaj memorie është runbook: një udhëzues operacional që ju tregon hap pas hapi se çfarë të bëni në një situatë të caktuar (shërbimi u ndërpre, disku i plotë, rezervimi dështoi). Këtu AI zgjidh problemin e "faqes së zbrazët" dhe "dembelizmit", të cilët janë armiqtë më të mëdhenj të shkrimit të dokumentacionit: prodhon një libër të organizuar nga shënimet tuaja të shpërndara, një procedurë nga një histori komande, një përshkrim nga një arkitekturë. Por parimi kritik: AI prodhon plane dhe skelete; Ju jeni ai që teston dhe vërteton çdo hap për të parë nëse është në të vërtetë i saktë – një runbook i gabuar është më i rrezikshëm sesa mungesa fare.
Në këtë njësi, fletore, post-mortem (raport hetimi pas ngjarjes), dokumentacioni arkitektonik dhe shkrimi i bazës së njohurive; Gjenerimi i drafteve me AI; dhe më e rëndësishmja do të mësoni rreziqet e dokumentacionit të paverifikuar.
Pse libri i gabuar i runbook është më i keq se pa runbook?
Ky është koncepti më i rëndësishëm i kësaj njësie. Një skuadër pa një listë të caktuar është e kujdesshme dhe e dyshimtë në kohë paniku; mendon dy herë për çdo komandë. Por dikush me një libër "zyrtar" e beson atë verbërisht - në mes të natës, nën stres, duke i kryer hapat pa diskutim. Nëse ai runbook lëshohet pa u prodhuar dhe testuar nga AI dhe ka një hap të gabuar (një komandë e gabuar, një parakusht i munguar, një hap prapa i anashkaluar), rezultati është katastrofik. Kjo është arsyeja pse çdo runbook i prodhuar me AI duhet të ekzekutohet nga fillimi në fund në një mjedis real dhe çdo hap duhet të verifikohet përpara se të publikohet. Një libër i paprovuar është si një premtim qetësues, por bosh.
Kujdes: Vulosni një fletore me "testuar: [date], [person]". Shënoni qartë draftet e paprovuara me etiketën "DRAFT — NUK VERIFIKOHET". Pra, askush nuk do të zbatonte me siguri hapa të paverifikuar në një krizë të vërtetë.
Anatomia e një libri të mirë
Një runbook i mirë përbëhet nga pjesë specifike dhe AI është i mirë në ndërtimin e këtij skeleti: titullin dhe qëllimin (për çfarë situate), parakushtet (çfarë aksesi, çfarë mjeti nevojitet), simptomat (kur e përdor këtë manual), hapat (me komanda të numëruara, të kopjueshme), vërtetimin (si të njohësh suksesin pas çdo hapi), rikthimin (si ta zhbëj nëse një hap shkon keq) dhe escal figure it. Ju mund t'i jepni AI-së shënimet tuaja të shpërndara dhe t'i kërkoni që ta vendosë në këtë strukturë; Ju vetëm siguroni saktësinë e përmbajtjes.
Hap pas hapi: Prodhimi i dokumentacionit me AI
- Mblidhni lëndën e parë. Historia juaj e komandave, shënimet tuaja, një email i vjetër, një regjistër i bisedave - materiali i vërtetë, edhe nëse i çrregullt, është më i mirë se fabrikimi i AI.
- Kërkoni strukturë. "Bëni këtë një libër me titujt e mëposhtëm: qëllimi, kushti paraprak, simptomë, hapat, verifikimi, rikthimi, përshkallëzimi."
- Ndalohet fabrikimi. "Mos shtoni komanda, IP, versione ose hapa që nuk ju kam dhënë; shënoni pjesët që mungojnë si [PER TË PLOTËSUAR]." Kjo parandalon gabimin më të rrezikshëm - hapat e sajuar në dukje të besueshme.
- Maskë. Përdorni mbajtësin e vendndodhjes në vend të hostit aktual, IP-së, përdoruesit; Nëse dokumenti ndahet, sekreti nuk duhet të zbulohet.
- Provoni atë. Drejtoni runbook nga fillimi në fund në një mjedis real (mundësisht test). Rregulloni çdo hap që nuk funksionon, mungon ose është i paqartë.
- Vulosni dhe publikoni. Shto datën e testimit, testuesin dhe përditësimin e fundit. Dokumentacioni është i gjallë; Duhet të përditësohet kur sistemi ndryshon.
tre mini kuti
Rasti 1 - 2 orë punë, 15 minuta. Një administrator e kishte shtyrë për muaj të tërë dokumentimin e procedurës së rivendosjes së kopjeve rezervë. Ai i dha historisë së komandës së terminalit (të maskuar) dhe disa shënime të shpërndara në AI dhe e futi atë në kornizën e runbook. AI prodhoi një skicë të pastër në 15 minuta. Administratori i kaloi 45 minutat e ardhshme duke ekzekutuar draftin nga fillimi në fund në një server testimi dhe duke rregulluar dy hapat që mungojnë. Rezultati: një libër i testuar, i besueshëm.
Rasti 2 - Kapur në mënyrë të rreme. Një ekip i kërkoi AI të shkruante një libër rifillimi të shërbimit, por harroi të ndalonte "fabrikimin". YZ shtoi një komandë "pastro cache së pari", e cila duket logjike, por nuk ekziston në atë shërbim. Për fat të mirë, inxhinieri drejtoi runbook në mjedisin e testimit; Kjo komandë dha një gabim. Hapi i provës kapi një hap të sajuar që do të krijonte konfuzion në një krizë të vërtetë.
Rasti 3 - Pas vdekjes i përshpejtuar. Pas një ndërprerjeje të madhe, ekipi duhej të shkruante një post-mortem, por askush nuk mund të fillonte. Ata ia dorëzuan inteligjencën artificiale afatin kohor të ngjarjes dhe regjistrat e maskuar dhe kërkuan një skelet të pafajshëm pas vdekjes - përmbledhje, ndikim, afat kohor, shkaku rrënjësor, veprime korrigjuese. Plani i AI reduktoi punën e një ore në dhjetë minuta; Ekipi ia kushtoi energjinë e tij verifikimit të fakteve dhe sqarimit të pikave të veprimit.
Katër shabllone të kopjueshëm
1) Gjenerimi i një skeleti të një libri të shkurtër:
Roli juaj: SRE i lartë. Krijo një runbook nga historiku i shënimeve/komandave të maskuara më poshtë. Titujt: Qëllimi, Kushtet paraprake, Simptomat (kur duhet përdorur), Hapat (të numëruar, mund të kopjohen), Verifikimi në çdo hap, Rikthimi, Përshkallëzimi. RREGULLI: Mos krijoni asnjë komandë/IP/version/hap që nuk ju jap; shkruani pjesët që mungojnë [TË PLOTËSOHEN]. Materiali: [shënim i maskuar]
2) Pas vdekjes pa faj:
Roli juaj: lehtësues i hetimit të incidentit. Shkruani një skicë pas vdekjes pa fajësi nga afati kohor i maskuar dhe regjistrat e mëposhtëm: Përmbledhja, Ndikimi (kohëzgjatja/fushëveprimi), Afati kohor, Shkaku rrënjësor (nëse verifikohet), Faktorët Kontribuues, Veprimet korrigjuese (pronari + përparësia). Mos e fajësoni personin, përqendrohuni te sistemi. Mos shkruani shkakun rrënjësor pa prova. Të dhënat: [...]
3) Arkitektura/përshkrimi i shërbimit:
Shkruani një dokument shërbimi nga informacioni i mëposhtëm i konfigurimit/diagramit të maskuar: çfarë bën shërbimi, nga çfarë përbërësish përbëhet, cilat janë varësitë e tij, si rrjedhin të dhënat, cilat porta/protokolle. Mbajeni atë teknik por të lexueshëm. Shënoni marrëdhënien për të cilën nuk jeni të sigurt si "ka nevojë për verifikim". Informacion: [i maskuar]
4) Auditimi i rifreskimit të dokumentacionit:
Rishikoni dokumentin ekzistues vijues dhe kontrolloni për monedhën: (1) cilat seksione mungojnë/të paqarta, (2) cilat hapa duken të patestuara, (3) çfarë informacioni mund të jetë i vjetëruar? Shkruani se çfarë duhet të pyes / verifikoj për çdo gjetje. Dokumenti: [dokument i maskuar]
Prompt i dobët / Prompt i fortë
Njoftim i dobët:
Më shkruaj një libër të mirëmbajtjes së serverit.
Nuk ka material të vërtetë. AI prodhon një tekst, tërësisht nga njohuritë e veta të përgjithshme, që nuk i përshtatet mjedisit tuaj ose madje përmban hapa të sajuar. Ky është një burim i rrezikshëm i besimit të rremë.
Njoftim i fuqishëm:
Roli juaj: SRE i lartë. Më poshtë është historia e komandës së maskuar dhe shënimet e mia që kam zbatuar në ngjarjen "Disk i plotë i shërbimit të pagesës". Krijo një libër nga këto: Qëllimi, Parakushti (qasja/mjet), Simptoma, Hapat e numëruar (me komandat e mia), Verifikimi në çdo hap, Rikthimi, Përshkallëzimi. Mos më bëj të ndjek një urdhër që nuk e kam dhënë; Bëje vendin bosh [PER TË PLOSUAR]. Vendosni një paralajmërim "jo testuar" në fund. Materiali: [Historiku i komandës së maskuar]
Lloji i dokumentit
Kontributi i AI
Kontributi i detyrueshëm i njeriut
fletore
Skelet + plan urbanistik
Testim në mjedis real, saktësi
Pas vdekjes
Skicë + strukturë
Verifikoni faktet dhe shkakun rrënjësor
dokument arkitektonik
Përshkrimi + rrjedhë
Konfirmoni marrëdhëniet dhe varësitë
Artikulli i bazës së njohurive
draft i shpejtë
Kontrolli i rrymës dhe saktësisë
Gabimet e zakonshme
- Publikimi i librave të paprovuar. Hapat e paverifikuar zbatohen verbërisht në krizë; Libri i gabuar është katastrofë.
- Të mos vendoset ndalimi i fabrikimit. Nëse nuk i thoni AI "mos shto atë që nuk kam dhënë", do të prodhojë hapa të arsyeshëm por jorealiste.
- Duke anashkaluar maskimin. Sekreti zbulohet kur ndahet dokumenti që përmban hostin e vërtetë, IP-në dhe përdoruesin.
- Nuk po përditësohet dokumenti. Dokumentet që nuk përditësohen kur ndryshon sistemi bëhen mashtruese me kalimin e kohës.
- Botim pa vulë. Nuk është e qartë nëse një dokument pa datë dhe status testimi është i besueshëm apo draft.
Këshillë: Mënyra më e mirë për ta mbajtur dokumentacionin "të gjallë" është ta lidhni atë me procesin e ndryshimit: kur një sistem ndryshon, lëreni që përditësimi i runbook përkatës të jetë një nga kriteret e përfundimit për ndryshimin. AI shpejton përditësimin, por ju jeni procesi i nxitjes.
Në përmbledhje
Dokumentacioni është memorie institucionale; Runbook është një udhëzues operacional që shpëton jetë në kohë krize. AI prodhon skica të organizuara nga shënimet tuaja të çrregullta, duke zgjidhur problemin e faqeve të zbrazëta dhe dembelizmit. Por e vërteta më kritike është kjo: një regjistër i gabuar është më i rrezikshëm se aspak, sepse zbatohet verbërisht në një krizë. Pra, ndaloni AI të "fabrikojë", maskoni atë dhe provoni dhe vulosni tërësisht çdo libër në një mjedis real. Mbajeni dokumentin të gjallë ndërsa sistemi ndryshon. AI ndërton kornizën; Ju jeni ai që garanton saktësinë dhe testimin.
Detyra e aplikimit
Zgjidhni një procedurë që nuk është e dokumentuar në ekipin tuaj (për shembull, rinisja e një shërbimi ose rivendosja e një kopje rezervë). Maskojeni historinë dhe shënimet tuaja përkatëse të komandës dhe lërini AI të krijojë një draft duke përdorur shabllonin "Runbook gjenerimi i skeletit" më sipër; Sigurohuni që të vendosni një ndalim për trillimet. Ekzekutoni draftin në një mjedis testimi dhe shënoni dhe rregulloni çdo hap të prishur/të munguar. Shtoni datën e testimit dhe informacionin e testuesit në runbook. Shkruani ndryshimet që prodhon AI dhe korrigjoni në proces në 5 artikuj.
listë kontrolli
- [ ] E krijova runbook nga materiali real (shënim, histori komandimi), a nuk e kam krijuar nga e para?
- [ ] A e kam ndaluar AI nga "shtimi i komandave/IP-ve/hapave që nuk i kam dhënë"?
- [ ] A kam maskuar informacione të ndjeshme si hosti, IP dhe përdoruesi?
- [ ] A e kam ekzekutuar dhe vërtetuar runbook në një mjedis real/test?
- [ ] A kam shtuar datën e testimit, testuesin dhe informacionin e përditësimit të fundit?
- [ ] A kam planifikuar ta lidh dokumentin me procesin e ndryshimit të sistemit dhe ta mbaj të përditësuar?