Išsiaiškinkite užduotį ir sprendimą
Šis vadovas paverčia žiniatinklio kabliukus ir paketinį apdorojimą peržiūrima darbo eiga. Jis sujungia domeno sprendimus, nuosavybės teisę, įrodymus ir priėmimą, kad rezultatas ir toliau veiktų gamyboje.
Pasirinkite sinchroninį, „Webhook“ arba paketinį pristatymą iš apimties, delsos, pakartotinio bandymo ir veiklos nuosavybės.
Praktinė eiga
- 1
Atsargų šaltinio tipai, identifikatoriai, laukai, lokalės, savininkai ir publikavimo būsenos.
- 2
Pasirinkite pristatymo modelį iš apimties, delsos, redakcinės kontrolės ir klaidų tolerancijos.
- 3
Susiekite šaltinio įrašą su atskiru kalbos versijos įrašu su patvariu ryšiu.
- 4
Pridėkite autentifikavimo, idempotencijos, pakartotinio bandymo, talpyklos negaliojimo, registravimo ir prieigos valdiklius.
- 5
Bandomasis leidinys, šaltinio pakeitimai, nepasiekiami rezultatai, atšaukimas, klaviatūros veikimas ir stebėjimas prieš išleidžiant.
Pavyzdys arba priemonė
Gyvavimo ciklo diagrama tampa įgyvendinimo sutartimi dėl pakartotinių bandymų, idempotencijos, stebėjimo ir pakartojimo. Įrankyje taip pat įrašykite pradinę padėtį, savininką, sprendimą, įrodymus, atvirą problemą ir patvirtinimo datą. Naudokite tikrą puslapį arba operaciją, kad komanda matytų priklausomybes, išimtis ir priežiūros darbus po išleidimo.
| Sprendimo taškas | Įrašas | Priėmimo kriterijus |
|---|---|---|
| Bazinė linija | Stebėta dabartinė būklė | Įrašymo šaltinis ir data |
| Sprendimas | Pasirinktas variantas ir pagrindimas | Atsižvelgta į riziką ir auditoriją |
| Įrodymai | Išbandykite, dokumentuokite arba išmatuokite | Galima peržiūrėti ir atsižvelgiant į versiją |
| Patvirtinimas | Vardas, vaidmuo ir data | Atitiko visi privalomi kriterijai |
Pasirinkite pristatymą iš delsos, apimties ir nuosavybės
Naudokite sinchroninį pristatymą mažoms interaktyvioms užklausoms, kurios paprastai baigiamos per sąsajos skirtąjį laiką ir gali nedelsiant pranešti apie rezultatą. Naudokite žiniatinklio kabliukus, kai darbas yra asinchroninis, bet kiekvienas rezultatas turi būti įvestas į CMS, kai tik jis bus paruoštas. Naudokite paketinį apdorojimą dideliems suplanuotiems rinkimams, kontroliuojamam importui arba perkėlimui, kai pralaidumas ir atkuriamumas yra svarbesni nei tiesioginis pristatymas. Šablonai gali egzistuoti kartu, tačiau kiekviena turinio klasė turi turėti dokumentuotą numatytąjį nustatymą.
Įvertinkite dienos ir didžiausią apimtį, prekės dydį, priimtiną užbaigimo laiką, pakartotinio bandymo langą, užsakymo poreikį, tikrintojo pajėgumus ir eksploatacinį savininką. Greitas rezultatas neturi jokios vertės, jei redakcinė eilė negali jo apdoroti. Įtraukite ankstesnio ir paskesnio srauto apribojimus: CMS eksportą, API greitį, eilės darbuotojus, atgalinio skambučio galutinį tašką, duomenų bazės įrašymą, talpyklos panaikinimą ir peržiūros darbo krūvį. Pasirinkite paprasčiausią modelį, atitinkantį visą paslaugos tikslą.
| Šablonas | Naudokite kada | Esminis valdymas |
|---|---|---|
| Sinchroninis | Maža užklausa ir trumpa ribojama delsa | Baigėsi laikas saugiai bandant pakartotinai |
| Webhook | Nepriklausomų darbų turėtų būti greitai | Parašo tikrinimas ir idempotentų įvykių tvarkymas |
| Partija | Didelis kontroliuojamas komplektas ir suplanuotas užbaigimas | Manifestas, kontrolinis taškas, susitaikymas ir pakartojimas |
Įdiekite patikrinamą „Webhook“ gyvavimo ciklą
Priimkite tik HTTPS POST, patikrinkite parašą pagal neapdorotą turinį, patikrinkite laiko žymos toleranciją ir atmeskite nepalaikomas įvykių versijas. Prieš taikydami verslo pakeitimus išsaugokite įvykio ID pagal unikalų apribojimą. Grąžinkite sėkmę po ilgalaikio kvito, tada apdorokite asinchroniškai. Pasikartojantis įvykis grąžina sėkmę nekartojant šalutinio poveikio. Pasukite pasirašymo paslaptis su persidengimo laikotarpiu ir apribokite diagnostikos išvestį, kad ji neatskleistų parašų ar turinio.
Modelio būsenos, tokios kaip gauta, patvirtinta, suderinta, pritaikyta, ignoruojama, bandoma iš naujo ir nepavyko. Suderinkite rezultatą su užduoties ID, šaltinio ID, šaltinio versija, lokale ir režimu. Jei dabartinis šaltinis yra naujesnis, išsaugokite audito rezultatą, bet neatidarykite ir nepakeiskite dabartinio juodraščio. Tvarkykite netvarkingus įvykius pagal būsenos perėjimo taisykles, o ne pagal atvykimo tvarką. Turėkite atkūrimo įrankį, kuriam reikia priežasties, operatoriaus tapatybės ir apimties.
- 1
Patikrinkite transportavimą, neapdoroto teksto parašą, laiko žymą, įvykio tipą ir sutarties versiją.
- 2
Tęskite unikalų įvykį ir patvirtinkite ilgalaikį kvitą.
- 3
Prieš keisdami CMS, išspręskite užduotį ir tikslią šaltinio peržiūrą.
- 4
Taikykite idempotentinės būsenos perėjimą ir sukurkite peržiūrimą juodraštį.
- 5
Įrašykite užbaigimą arba nukreipkite įvykį į kontroliuojamą pakartotinį bandymą ir pakartojimą.
Padaryti partijas atkuriamas ir suderinamas
Sukurkite nekeičiamą manifestą su paketo ID, kūrimo laiku, užklausa arba pasirinkimo taisykle, atskiro elemento ID, šaltinio peržiūra, lokale, režimu, prioritetu ir kontroline suma. Užšaldykite aprašą prieš pateikdami, kad vėlesnė CMS užklausa negalėtų pakeisti paketo reikšmės. Padalinkite jį į ribotas dalis ir kiekvienam elementui naudokite stabilius idempotencijos raktus. Patikrinimo taško užbaigimas po patvarių įrašų, kad darbuotojai galėtų tęsti darbą nepradėdami iš naujo.
Pabaigoje suderinkite pateiktus, priimtus, užbaigtus, atmestus, pasenusius, nepavykusius ir tyčia praleistus elementus. Skaičiai turi atitikti pradinį aprašą, o kiekvienam neužbaigtam elementui reikia priežasties ir tolesnio veiksmo. Pakartojant poaibį sukuriamas naujas pakartojimo manifestas, susietas su originalu. Nekeiskite pradinių skaičių ir neištrinkite nepavykusių įrodymų. Paskelbkite paketinius rezultatus tik peržiūros būsenose, o darbo krūvio apribojimai apsaugo redaktorių komandą.
Apraše pataisoma elemento tapatybė, šaltinio peržiūra, nustatymai ir kontrolinė suma.
Kiekviena elemento operacija yra ideali ir gali būti bandoma atskirai.
Kontroliniai taškai atnaujinami po pertraukos nedubliuojant juodraščių.
Galutinės būsenos skaičiai tiksliai sutampa su manifestu.
Pakartojimas yra nustatytas, įgaliotas, susietas ir tikrinamas.
Stebėkite eiles ir repetuokite atkūrimą
Stebėkite priimtą rodiklį, užbaigimo rodiklį, klaidų dažnį pagal kategorijas, eilės gylį, seniausio elemento amžių, apdorojimo trukmės procentilius, žiniatinklio kablio patvirtinimo klaidas, pakartotinių bandymų skaičių, negyvų raidžių apimtį, pasenusių rezultatų rodiklį ir laiką nuo rezultato iki redakcinio patvirtinimo. Įspėjimas apie vartotojo poveikį ir augantį atsilikimą, o ne pavienius laikinus gedimus. Prietaisų skydeliai atskiria teikėjo apdorojimą, atgalinio skambučio pristatymą, CMS programą ir redakcinį laukimo laiką.
Runbook identifikuoja savininkus, saugią pristabdymą, mastelio keitimo ribas, kredencialų kaitaliojimą, pakartojimo patvirtinimą, mirusiųjų raidžių tvarkymą, teikėjo ryšį ir atkūrimo patvirtinimą. Prarastas atgalinis skambutis, pasikartojantis įvykis, netvarkingas įvykis, tiekėjo gedimas, CMS gedimas, schemos neatitikimas, pasibaigęs slaptas galiojimo laikas ir dalinis paketo užbaigimas. Norint priimti, reikia atkurti be pasikartojančio paskelbimo, tylaus praradimo, rankinio duomenų bazės redagavimo arba paskutinio patvirtinto turinio pašalinimo.
Vaidmenys, įrodymai ir patvirtinimas
Laikykite generavimą atskirai nuo publikavimo. Sėkmingas atsakymas yra juodraštis, o ne patvirtinimas. Išsaugokite šaltinio identifikatorių ir versiją, transformacijos nustatymus, rezultato identifikatorių, peržiūros būseną, tvirtintoją ir paskelbimo laiką. Pasikeitus šaltiniui, pažymėkite kalbos versiją, kad būtų galima peržiūrėti, o ne tyliai pakeiskite patvirtintą turinį. Tai leidžia atkurti ir atlikti auditą visose platformose.
Operacijos ir priežiūra
Darbas nesibaigia publikavimu. Susiekite kalbos versiją arba konfigūraciją su šaltiniu, stebėkite kokybės ir paslaugų priemones ir nustatykite konkrečius peržiūros veiksnius. Trigeriai apima šaltinio pakeitimus, teisinius pakeitimus, naujus auditorijos poreikius, pasikartojančius palaikymo klausimus, techninius pakeitimus ir incidentus. Įvardytas savininkas įvertina aktyviklį, prireikus atidaro naują versiją ir įrašo atnaujintą patvirtinimą.
Skelbimo kontrolinis sąrašas
Integruojant naudojami patvarūs šaltinio identifikatoriai.
Kredencialai saugomi serverio pusėje ir pasukami.
Apibrėžiamas skirtasis laikas, bandymas pakartotinai ir greičio ribojimo elgesys.
Pakartotiniai prašymai yra idempotenti.
Sugeneruotas turinys pereina į peržiūros būseną.
Šaltinio pakeitimai anuliuoja arba iš naujo atidaro versiją.
Kalbos navigacija veikia naudojant klaviatūrą ir pagalbines technologijas.
Stebėjimas apima gedimus, eiles, delsą ir pasenusį turinį.