Checkout xizmatining kanar relizi

1) Operatsiyalar hujjatlari nima uchun zarur?

• og’zaki bilimlarni takrorlanadigan tartib-taomillarga aylantiradi;
• javobgarlik chegaralarini va eskalatsiya nuqtalarini belgilaydi;
• komplayens va xavfsizlik uchun dalillar manbai bo’lib xizmat qiladi;
• onbordingni tezlashtiradi va «tor tomoqlar» xavfini kamaytiradi.

2) Hujjatlarning taksonomiyasi (nima nimaga)

Policy (Siyosat): niyat va doiralar («nima va nima uchun»). Misol: Hodisa-menejment siyosati.
Standard (Standart): majburiy minimal talablar («qancha»). Masalan: TLS sertifikatlarini yangilash muddatlari.
SOP/Procedure (Standart operatsion protsedura): ketma-ket qadamlar («sifatida»). Misol: Relizni kanareykali yoyilgan holda chiqarish.
Runbook: namunaviy hodisalar (alertlar/operatsiyalar) uchun bosqichma-bosqich koʻrsatmalar. Masalan: «API 5xx o’sdi - harakatlar algoritmi».
Playbook: variant va tirgakli skriptlar boʻyicha yechimlar toʻplami. Masalan: «To’lov provayderi bilan bog’liq muammolar».
KB (Bilimlar bazasi): javoblar, SSS, vositalar bo’yicha ma’lumotnomalar.
Checklist: Harakatlar oldidan majburiy bandlarning qisqacha roʻyxati.
Record/Evidence: bajarilgan qadamlar jurnali, skrinshotlar/loglar/imzolar.

3) Yaxshi hujjatlashtirish prinsiplari

Yagona haqiqat manbai (SSOT). Hujjatlar takrorlanmaydi; purkash eskirishni anglatadi.
Docs-as-Code. Biz Git’da saqlaymiz, code-review’dan o’tamiz, versiyalar va difflar ko’rinadi.
Actionable-first. Boshida - qisqacha kartochka: qachon ishga tushirish, egasi kim, nima qilish kerak, yakunlash mezonlari.
Atom va manzillilik. Bitta hujjat - bitta vazifa/jarayon.
Yangilanish imkoniyati. Aniq egasi va SLA yangilanishlari (masalan, har chorakda).
Kuzatish darajasi. Dashbordlar/alertlar/metriklarga havolalar oʻrnatilgan.
Xavfsizlik-by-design. Sezgirlikni tasniflash, sirlarni yashirish, kirishni nazorat qilish.

4) Hujjatning hayot sikli (Governance)

1. Tashabbus: ariza/chipta → hujjat turi → egasi.
2. Loyiha: namunasi, minimal namunalar, standartlar va SLOga havolalar.
3. Revyu: texnik (SRE/platforma/xavfsizlik), protsedura (jarayon menejeri).
4. Nashr etish: master filialda, versiya/sanani belgilash, maqom berish (active/experimental/deprecated).
5. O’qitish/Kommunikatsiya: o’zgarishlarni e’lon qilish, qisqa trening/demo.
6. Retrospektiv: hodisalar/mashqlar yakunlari bo’yicha tuzatishlar kiritish.
7. Audit va arxiv: o’zgarmas iz (kim/qachon o’zgartirdi), arxivdagi eskirgan versiyalar.

5) SOP/Runbook tuzilishi (minimal)

1. Kartochka: Nomi, Identifikatori, Versiyasi/Sanasi, Egasi, Mas’ul rollar, Bog’liq siyosatlar/standartlar.
2. Qachon qoʻllash kerak: ishga tushirish shartlari (alert/hodisa/ish oynasi).
3. Tayyorlash: huquqlar/vositalar/ma’lumotlar, tavakkalchilik-baholash, kommunikatsiyalar.
4. Qadamlar: raqamlangan, buyruqlar/skrinshotlar/kutilayotgan natijalar bilan.
5. Muvaffaqiyat/qaytish mezonlari: aniq SLI/SLO chegaralari.
6. Eskalatsiya: kim, qachon va qanday (kanal, telefon, provayder).
7. Xavfsizlik/komplayens: sezgir ma’lumotlar, taqiqlar, harakatlar yozuvlari.
8. Post-actions: chiptalarni yopish, maqomini yangilash, dalillarni to’plash.
9. Oʻzgarishlar tarixi (changelog).

6) Uslubi va rasmiylashtirish qoidalari

Aniq va qisqacha: 1 qadam - 1 harakat - 1 natija.
Imperiv: «Bajarish»..., «Tekshirish»..., «Orqaga qaytish»....
Skrinshotlar/buyruqlar: qadam yonida; buyruqlar - nusxa olinadigan bloklar; kutilayotgan xulosaga eʼtibor bering.
Oʻzgaruvchanlik: «Agar A → X qadam, agar B → Y qadam» filiallari.
Kogortlik: qayerda ahamiyatli - mintaqalarni/provayderlarni/tenantlarni koʻrsating.
Mahalliylashtirish: asosiy hujjatlar - kamida 2 tilda; Tarjimalarning holatini koʻrsating.
Tags va qidiruv: xizmat, komponent, provayder, hodisa turi, SLO, versiya.

7) Docs-as-Code va asboblar

Saqlash joyi: Git (main/feat/bugfix), PR-revyu, required checks.
Formati: Markdown/AsciiDoc; PlantUML/Mermaid diagrammalari; JSON/YAML sxemalari.
Nashr qilish: statik sayt (Docusaurus/MkDocs) + qidirish.
Verifikatsiya: CI-lint, havolalar testi, imlo, kod bloklari validatorlari.
Integratsiyalar: ChatOps ’/runbook open X’buyruqlari, oxirgi versiyani alertlarda koʻrsatish.
Aloqalar: CMDB/servis-katalog dashbordlar.

8) Foydalanishni nazorat qilish va tasniflash

Классы: Public / Internal / Confidential / Restricted.
Boʻlinish: ochiq koʻrsatmalar (umumiy maqomlar) vs yopiq (kalitlar, buyruqlar, tarmoq diagrammalari).
Sirlar: matnda taqiqlangan; sir saqlash va pleysholderlardan foydalanish.
Audit: sezgir SOP uchun oʻqish/oʻzgartirish jurnali.

9) Hodisalar va relizlar bilan aloqa

Har bir alertda - tegishli runbook’ga havola.
Har bir hodisada - foydalanilgan SOPga havola va belgi cheki.
RCA dan keyin - CAPA-harakat sifatida hujjatlarni yangilash.
Chiqarishdan oldin - checklist: qaytish tayyorligi, tanazzul bayroqlari, provayderlar aloqalari.

10) Minimal majburiy to’plam (MVP-doc-paket)

Insident-menejment va eskalatsiya siyosati (SEV/P-darajalar, tayminglar).
Monitoring va alert-siyosat standarti (burn rate, kvorum).
SOP: reliz/orqaga qaytish (canary/blue-green), migratsiya DB (expand/contract).
Runbook: «Yuqori error-rate», «O’sish p99», «To’lovlar muvaffaqiyatining pasayishi», «TLS/DNS muammosi».
Tashqi provayderlarning Playbook (toʻlovlar/KYC/CDN): aloqalar, limitlar, folbeklar.
Sirlarni va kirishlarni boshqarish siyosati.
RCA va Post-mortem namunalari.
Servislar egalari jadvali (RACI) va dashbordlar xaritasi.

11) Hujjatlar sifati metrikasi (hujjatning SLO)

Coverage: SOP/Runbook bilan bog’liq o’ta muhim yo’llar%.
Freshness: hujjatlar ulushi N kundan yangi (masalan, 90).
Foydalanuvchanlik:% runbook boʻyicha eskalatsiyasiz yopilgan hodisalar.
Findability: kerakli hujjatni qidirish vaqtining mediani (soʻrov/log boʻyicha).
Defect rate: izohlar soni/100 hujjat.
Adoption: runbook’ga toʻgʻri havola qilingan alertlar ulushi.
Compliance evidence rate: ilova qilingan dalillar bilan vazifalar%.

12) Chek-varaqlar

SOP yaratish cheki

• Egasi va maqsadli auditoriyasi aniqlandi.
• Ishga tushirish shartlari va to’xtash mezonlari mavjud.
• Qadamlar boshqa muhandis tomonidan takrorlanadi va tekshiriladi.
• Dashboard/alert/instrumentlarga havolalar oʻrnatilgan.
• Sirsiz; pleysholderlar va vault bogʻlamasi mavjud.
• Orqaga qaytish va eskalatsiya tasvirlangan.
• «Harakatlardan keyin» chek varaqasi qoʻshilgan.
• Versiya, sana, changelog.

Revyu chek-varaqasi

• Hujjat taksonomiyaga mos keladi (siyosat va qadamlarni aralashtirmaydi).
• Til oddiy, imperativ, noaniqliklarsiz.
• Buyruqlar «quruq poygada «/steyjda tekshirilgan.
• Xavf-xatarlar va nazorat nuqtalari ko’rsatilgan.
• Foydalanish imkoniyati (Internal/Restricted) toʻgʻri.
• CI’da linterlar/validatorlar o’tdi.

13) Mahalliylashtirish, versiya va foydalanish imkoniyati

Versiya:’MAJOR. MINOR. PATCH’, bu yerda MAJOR jarayonlarning mosligini buzadi.
Tillar: «manba» tilini va tarjimalar holatini belgilang (up-to-date/needs review).
Form-omil: on-call uchun mobil/tungi ko’rsatuv, IC bosma kartochkalar.

14) Dok-avtomatlashtirish (amaliyotdan)

CLI (’doc new sop --service = payments’) shablonlaridan SOP ramkalarini yaratish.
Xizmat teglari boʻyicha oxirgi dashbordlarga bogʻlamalarni avto qoʻyish.
Muddati o’tgan hujjatlar haqida eslatma botlar (freshness SLA).
Audit uchun Evidence paketini (PDF/ZIP) eksport qilish.
Hal qilishda foydalanilgan hujjatlar versiyasi bilan hodisalar biletlarini bog’lash.

15) Xavfsizlik va komplayens

«Tavakkalchiliklar» va «Nazorat tadbirlari» majburiy bo’limlari.
Evidence’ni oʻzgarmas arxivda imzo/xeshlar bilan saqlash.
Normativlarga bog’lash (masalan, xabarnoma/retensiya muddatlari), aniq muvofiqlik egalari.

16) Anti-patternlar

«Viki-labirint» egalari va yangilanish sanasisiz.
Jamoalar bilan aralashgan siyosatchilar - hech kim nimani bajarishni bilmaydi.
Kontekstsiz hujjatlar (SLO, dashbordlar, eskalatsiyalar yo’q).
Sirli skrinshotlar yoki CLI-muqobillarsiz «bu erga bosing».
«Bitta guru qanday qilishni biladi» - tribal knowledge.
Arxiv PDF’lari yagona versiya sifatida tahrir qilinmaydi, qidirilmaydi.

17) Shablonlar (parchalar)

SOP shapkasi (misol)

SOP-ID: OPS-REL-001

18) Kundalik ishga kiritish

Haftalik doc-to’garaklar: 1-2 ta hujjatni tahlil qilish, dolzarblashtirish, tajriba almashish.
Game-days: simulyatsiyalarda SOP/Runbook haqiqatini tekshirish.
Onbording: majburiy hujjatlar to’plami orqali yangi boshlanuvchining yo’nalishi + qisqa kvizalar.
Doc-qarz: ustuvorlik bilan yaxshilashlar beklogi (impact × effort).

19) Jami

Operatsiya hujjatlari arxiv emas, balki ish vositasidir. Agar u kod sifatida yuritilsa, egalari, yangilik metrikasi bo’lsa va noxush hodisalar, relizlar va o’qitishga o’rnatilsa, tashkilot oldindan aytib bo’lmaydigan bo’lib qoladi: xatolar kamroq, tezroq reaktsiya, tushunarli javobgarlik va auditga tayyorlik. Qisqa yozing, muntazam ravishda yangilang, tartib-qoidalarni avtomatlashtiring - va hujjatlar vaqt va pulni tejashni boshlaydi.