Табыстар:
- Жасанды интеллектпен шашыраңқы жазбалардан runbook, өлгеннен кейінгі және архитектуралық құжат қаңқасын жасау мүмкіндігі
- «Жасауға тыйым салу» және әрбір runbook-ті нақты ортада мұқият сынау және белгілеу тәртібін орындау мүмкіндігі
- Қате runbook жоққа қарағанда қауіпті екенін түсіну және өзгерту процесі арқылы құжаттаманы сақтау мүмкіндігі
Құжаттама және ақпаратты басқару: Runbook, сәулет және AI көмегімен институционалдық жады
Жүйені басқарудың ең назардан тыс қалған, бірақ өмірді сақтайтын міндеті - құжаттама. Жүйе істен шығып, оны құрастырған адам демалыста болса және оны қалай қалпына келтіруге болатыны туралы жазбаша сөз болмаса, бұл бәрі үшін ұзақ түн. Құжаттама - жүйенің қалай орнатылғанын, қалай жұмыс істейтінін және ақаулық туындаған жағдайда не істеу керектігін жазбаша және қолжетімді ететін институционалдық жад. Бұл жадтың ең маңызды түрі – runbook: берілген жағдайда (қызмет бұзылған, диск толы, сақтық көшірме жасау сәтсіз болған) қадам бойынша не істеу керектігін көрсететін операциялық нұсқаулық. Мұнда AI құжаттама жазудың ең үлкен жаулары болып табылатын «бос парақ» және «жалқаулық» мәселесін шешеді: ол шашыраңқы жазбаларыңыздан ұйымдастырылған жұмыс кітабын, пәрмендер тарихынан процедураны, архитектурадан сипаттаманы шығарады. Бірақ маңызды принцип: AI сызбалар мен қаңқаларды шығарады; Сіз оның шын мәнінде дұрыстығын тексеру үшін әрбір қадамды сынап, растайсыз — қате runbook мүлде жоққа қарағанда қауіптірек.
Бұл бөлімде runbook, өлгеннен кейінгі (оқиғадан кейінгі тергеу есебі), архитектуралық құжаттама және білім базасын жазу; AI көмегімен жобаларды құру; және ең бастысы тексерілмеген құжаттаманың тәуекелдерін үйренесіз.
Неліктен қате runbook runbook жоққа қарағанда нашар?
Бұл осы бірліктің ең маңызды тұжырымдамасы. Runbook жоқ команда дүрбелең кезінде сақтық танытады және күдіктенеді; әр пәрменді екі рет ойлайды. Бірақ «ресми» runbook бар біреу оған соқыр сенеді - түн ортасында, стресс жағдайында, қадамдарды еш күмәнсіз орындайды. Егер бұл runbook жасанды интеллект арқылы жасалмаса және тексерілмей шығарылса және бір қадам қате болса (қате пәрмен, жетіспейтін алғышарт, өткізіп алынған қалпына келтіру қадамы), нәтиже апатты болады. Сондықтан AI көмегімен жасалған әрбір runbook нақты ортада басынан аяғына дейін іске қосылуы керек және әрбір қадам жарияланғанға дейін тексерілуі керек. Тексерілмеген runbook - сенімді, бірақ бос уәде сияқты.
Ескерту: «тексерілген: [күн], [адам]» деген жазумен жұмыс кітабына мөртаңба қойыңыз. Тексерілмеген жобаларды «ЖОБА — ТЕКСЕРілмеген» белгісімен анық белгілеңіз. Сондықтан нақты дағдарыс кезінде ешкім тексерілмеген қадамдарды қауіпсіз қолдана алмайды.
Жақсы жүгіру кітапшасының анатомиясы
Жақсы runbook белгілі бір бөліктерден тұрады және AI бұл қаңқаны құруда жақсы: тақырып және мақсат (қандай жағдай үшін), алғышарттар (қандай қол жеткізу, қандай құрал қажет), белгілер (бұл runbook қашан қолданамын), қадамдар (нөмірленген, көшірілетін пәрмендермен), тексеру (әр қадамнан кейін сәтті қалай тануға болады), кері қайтару (қадам нашар болса, оны қалай қайтаруға болады) және мен оны жоюға болады (егер есептей алмаймын). Сіз AI-ге шашыраңқы жазбаларыңызды беріп, оны осы құрылымға енгізуді сұрай аласыз; Сіз тек мазмұнның дәлдігін қамтамасыз етесіз.
Қадамдық: AI көмегімен құжаттама жасау
- Шикізатты жинаңыз. Пәрмендер журналы, жазбалар, ескі электрондық пошта, сөйлесу журналы — нақты материал, тіпті бейберекет болса да, AI жасаудан жақсырақ.
- Құрылымды сұраңыз. «Оны келесі тақырыптары бар жұмыс кітабын жасаңыз: мақсат, алғышарт, симптом, қадамдар, тексеру, кері қайтару, күшейту».
- Жасандылыққа тыйым салу. "Мен бермеген пәрмендерді, IP мекенжайларын, нұсқаларды немесе қадамдарды қоспаңыз; кез келген жетіспейтін бөліктерді [ТОЛтырылатын] деп белгілеңіз." Бұл ең қауіпті қатені болдырмайды - көрінетіндей ойластырылған қадамдар.
- Маска. Нақты хост, IP, пайдаланушы орнына толтырғышты пайдаланыңыз; Егер құжат ортақ болса, құпияны жария етпеу керек.
- Оны сынап көріңіз. Runbook бағдарламасын басынан аяғына дейін нақты (мүмкіндігінше сынақ) ортада іске қосыңыз. Жұмыс істемейтін, жетіспейтін немесе түсініксіз қадамдарды түзетіңіз.
- Мөр қою және жариялау. Сынақ күнін, сынақ құралын және соңғы жаңартуды қосыңыз. Құжаттама жанды; Жүйе өзгерген кезде оны жаңарту қажет.
үш шағын іс
1-жағдай — 2 сағат жұмыс, 15 минут. Әкімші бірнеше ай бойы сақтық көшірмелерді қалпына келтіру процедурасын құжаттауды кейінге қалдырды. Ол AI-ге терминалдық командалар тарихын (маскаланған) және бірнеше шашыраңқы жазбаларды берді және оны runbook құрылымына енгізді. AI 15 минут ішінде ұқыпты контур жасады. Әкімші келесі 45 минутта жобаны басынан аяғына дейін сынақ серверінде іске қосып, жетіспейтін екі қадамды түзетеді. Нәтиже: тексерілген, сенімді жұмыс кітабы.
2-жағдай - жалған ұсталды. Команда AI-ға қызметті қайта іске қосу кітабын жазуды тапсырды, бірақ «ойдан шығаруға» тыйым салуды ұмытып кетті. YZ "алдымен кэшті тазалау" пәрменін қосты, ол логикалық болып көрінеді, бірақ бұл қызметте жоқ. Бақытымызға орай, инженер сынақ ортасында жұмыс кітабын іске қосты; Бұл команда қате берді. Сынақ қадамы нақты дағдарыста шатасу тудыратын ойластырылған қадамды қамтыды.
3-жағдай – Өлімнен кейінгі жеделдетілген. Күрделі үзілістен кейін командаға өлімнен кейінгі жазу керек болды, бірақ ешкім бастай алмады. Олар оқиғаның хронологиясын және бүркенішті журналдарды AI-ға тапсырды және кінәсіз қаңқаны сұрады - қорытынды, әсер, уақыт кестесі, негізгі себеп, түзету әрекеттері. AI жобасы бір сағаттық жұмысты он минутқа дейін қысқартты; Команда өзінің күшін фактілерді тексеруге және әрекет элементтерін нақтылауға жұмсады.
Көшірілетін төрт үлгі
1) runbook қаңқасын жасау:
Сіздің рөліңіз: аға SRE. Төмендегі маскаланған жазбалардан/пәрмендер журналынан жұмыс кітабын жасаңыз. Тақырыптар: Мақсат, Алғышарттар, Симптомдар (қашан пайдалану керек), Қадамдар (нөмірленген, көшіруге болады), Әр қадамда тексеру, Кері қайтару, Эскалация. ЕРЕЖЕ: Мен сізге бермеген команданы/IP/нұсқаны/қадамды жасамаңыз; жетіспейтін бөліктерді жазыңыз [ТОЛтырылуы керек]. Материал: [маскаланған жазба]
2) Кінәсіз өлгеннен кейін:
Сіздің рөліңіз: оқиғаны тергеу жөніндегі көмекші. Келесі бетперделенген уақыт шкаласы мен журналдардан КІНӘСІЗ ТЕГІН өлгеннен кейінгі эскизді жазыңыз: Түйіндеме, Әсер (ұзақтығы/ауқымы), Хронология, Түпкі себеп (тексерілсе), ықпал етуші факторлар, Түзету әрекеттері (ие + басымдық). Адамды кінәламаңыз, жүйеге назар аударыңыз. Дәлелсіз негізгі себеп жазбаңыз. Деректер: [...]
3) Архитектура/қызмет сипаттамасы:
Келесі маскаланған конфигурация/диаграмма ақпаратынан қызмет құжатын жазыңыз: қызмет не істейді, ол қандай құрамдастардан тұрады, оның тәуелділіктері қандай, деректер қалай ағыны, қандай порттар/протоколдар. Оны техникалық, бірақ оқуға болатындай сақтаңыз. Сіз сенімді емес қарым-қатынасты «тексеруді қажет етеді» деп белгілеңіз. Ақпарат: [маскалы]
4) Құжаттаманы жаңарту аудиті:
Келесі бар құжатты қарап шығыңыз және валютаны тексеріңіз: (1) қандай бөлімдер жоқ/түсініксіз, (2) қандай қадамдар тексерілмеген болып көрінеді, (3) қандай ақпарат ескірген болуы мүмкін? Әрбір қорытынды үшін не сұрауым/тексеруім керек екенін жазыңыз. Құжат: [маскирленген құжат]
Әлсіз шақыру / Күшті шақыру
Әлсіз шақыру:
Маған серверге техникалық қызмет көрсету кітабын жазыңыз.
Нақты материал жоқ. AI сіздің ортаңызға сәйкес келмейтін немесе тіпті жасалған қадамдарды қамтитын өз жалпы біліміне негізделген мәтінді жасайды. Бұл жалған сенімнің қауіпті көзі.
Күшті шақыру:
Сіздің рөліңіз: аға SRE. Төменде маскаланған пәрмендер журналы және мен "төлем қызметі дискі толы" оқиғасында орындаған жазбаларым берілген. Мыналардың ішінен жұмыс кітабын жасаңыз: Мақсат, Алғышарт (қолжетімділік/құрал), Белгі, Нөмірленген қадамдар (менің командаларыммен), Әрбір қадамдағы тексеру, Кері қайтару, Эскалация. Мен бермеген бұйрықты орындауға мәжбүрлеме; [ТОЛтырылатын] бос жолды жасаңыз. Соңында «тексерілмеген» ескертуін қойыңыз. Материал: [маскаланған командалар тарихы]
Құжат түрі
AI үлесі
Адамның міндетті үлесі
runbook
Қаңқа + орналасу
Нақты ортада тестілеу, дәлдік
Өлімнен кейінгі
Құрылым + құрылым
Фактілер мен негізгі себептерді тексеріңіз
сәулет құжаты
Сипаттама + ағын
Қарым-қатынастар мен тәуелділіктерді растаңыз
Білім қоры туралы мақала
жылдам жоба
Ағымдылық пен дәлдікті тексеру
Жалпы қателер
- Тексерілмеген runbooks басып шығару. Тексерілмеген қадамдар дағдарыс жағдайында соқыр жүзеге асырылады; Қате runbook - апат.
- Жасандылыққа тыйым салмау. Егер сіз AI-ға «мен бермегенді қоспаңыз» деп айтпасаңыз, ол ақылға қонымды, бірақ шындыққа жанаспайтын қадамдар жасайды.
- Масканы өткізіп жіберу. Құпия нақты хостты, IP мекенжайын және пайдаланушыны қамтитын құжат ортақ пайдаланылған кезде ашылады.
- Құжатты жаңартпайды. Жүйе өзгерген кезде жаңартылмайтын құжаттар уақыт өте келе жаңылыстырады.
- Мөрсіз басып шығару. Сынақ мерзімі мен мәртебесі жоқ құжат сенімді ме, әлде жоба ма, белгісіз.
Кеңес: Құжаттаманы «тірі» сақтаудың ең жақсы жолы оны өзгерту процесіне байланыстыру болып табылады: жүйе өзгерген кезде, сәйкес жұмыс кітабын жаңарту өзгертуге арналған аяқтау критерийлерінің бірі болсын. AI жаңартуды жылдамдатады, бірақ сіз іске қосу процесісіз.
Қысқаша
Құжаттама – институционалдық жады; Runbook дағдарыс кезінде адамдардың өмірін сақтап қалатын операциялық нұсқаулық болып табылады. Жасанды интеллект бос парақтар мен жалқаулық мәселесін шешіп, бейберекет жазбалардан ұйымдастырылған жобаларды жасайды. Бірақ ең маңызды шындық мынада: қате runbook мүлде жоққа қарағанда қауіпті, өйткені ол дағдарыс кезінде соқыр түрде қолданылады. Сондықтан AI-ны «жасауға» тыйым салыңыз, оны бүркеңіз және әрбір runbook-ті нақты ортада мұқият сынап, штамптаңыз. Жүйе өзгерген кезде құжатты тірі қалдырыңыз. AI құрылымды құрады; Сіз дәлдік пен сынаққа кепілдік бересіз.
Қолданбалы тапсырма
Топта құжатталмаған процедураны таңдаңыз (мысалы, қызметті қайта іске қосу немесе сақтық көшірмені қалпына келтіру). Тиісті пәрмендер журналы мен ескертпелеріңізді жасырыңыз және AI жоғарыдағы "Runbook қаңқасының генерациясы" үлгісін пайдаланып жобаны жасауын сұраңыз; Жасандылыққа тыйым салуды ұмытпаңыз. Сынақ ортасында жобаны іске қосыңыз және белгі қойыңыз және кез келген бұзылған/жетпеген қадамдарды түзетіңіз. Жұмыс кітабына сынақ күні мен сынақшы ақпаратын қосыңыз. AI шығаратын айырмашылықтарды жазыңыз және процесте 5 тармақта түзетіңіз.
бақылау парағы
- [ ] Мен жұмыс кітабын нақты материалдан жасадым (ескертпе, пәрмендер тарихы), мен оны нөлден құрастырған жоқпын ба?
- [ ] Мен AI-ға «мен бермеген пәрмендерді/IP мекенжайларын/қадамдарды қосуға» тыйым салдым ба?
- [ ] Мен хост, IP және пайдаланушы сияқты құпия ақпаратты жасырдым ба?
- [ ] Мен runbook бағдарламасын нақты/сынақ ортасында іске қосып, тексердім бе?
- [ ] Сынақ күнін, сынақ құралын және соңғы жаңарту ақпаратын қостым ба?
- [ ] Құжатты жүйені өзгерту процесіне байланыстыруды және оны жаңартуды жоспарладым ба?