Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Workflow patvarumas ir patikimumas

Paskaita 2 iš 14 Atnaujinta 2026 m. liepos 29 d. Pažengusiems
Šiame puslapyje
  1. Kodėl patvarumas keičia viską
  2. Įvykių šaltinis: pagrindinis principas
  3. Automatinis perkartojimas: atsigavimas po gedimo
  4. Atsparumas klaidoms: dengiami scenarijai
  5. Determinizmo apribojimas
  6. Palyginimas su tradiciniais požiūriais
  7. Tiksliai vieną kartą: loginė garantija
  8. Svarbiausi punktai

Kodėl patvarumas keičia viską

Įsivaizduok dešimties žingsnių konvejerį, apdorojantį sąskaitų faktūrų partiją: ištraukimas, validavimas, modelio užklausa, rašymas į duomenų bazę, pranešimas. Standartiniame „Python“ scenarijuje gedimas 7-ame žingsnyje verčia grįžti prie 1-ojo. Pirmieji šeši žingsniai vykdomi iš naujo, kas sukelia rimtų problemų, jei kuris nors iš jų jau įrašė duomenis į duomenų bazę arba išsiuntė žinutę. Naudojant patvarų workflow, sistema tęsia darbą tiksliai nuo 7-ojo žingsnio. Ji praleidžia pirmuosius šešis žingsnius, išvengia veiksmų dubliavimo ir nepraranda jokių duomenų.

Ši galimybė remiasi specifiniu mechanizmu, vadinamu įvykių šaltiniu (event sourcing). Suprasti šią sąvoką būtina, nes ji paaiškina apribojimus, su kuriais susidursi vėliau.

Įvykių šaltinis: pagrindinis principas

Įvykių šaltinis fiksuoja kiekvieną workflow veiksmą kaip nekintamą įvykį žurnale. Skirtumas nuo tradicinio požiūrio telpa į vieną sakinį: vietoj to, kad būtų saugoma tik dabartinė būsena (pvz., „vykdoma, 7-as žingsnis“), platforma saugo visą operacijų ir jų rezultatų istoriją. Workflow vykdymas su dviem veiklomis palieka tokį pėdsaką:

  1. Workflow prasideda ir gauna įvesties parametrus → įvykis įrašomas
  2. Workflow iškviečia A veiklą → įvykis įrašomas
  3. A veikla užbaigiama su rezultatu → įvykis įrašomas
  4. Workflow iškviečia B veiklą → įvykis įrašomas
  5. B veikla užbaigiama → įvykis įrašomas
  6. Workflow grąžina galutinį rezultatą → įvykis įrašomas

Sistema išsaugo kiekvieną žingsnį prieš pereidama prie kito. Nėra nė vieno momento, kai veiksmas įvyktų be žurnalo žinios. Šis žurnalas tampa vieninteliu tiesos šaltiniu; workflow būsena neegzistuoja niekur kitur.

Automatinis perkartojimas: atsigavimas po gedimo

Kai darbuotojas (worker) stringa, perima kitas darbuotojas, atsisiunčia įvykių žurnalą ir perkartoją workflow kodą nuo pat pradžių. Žodis „perkartojimas“ dažnai nustebina: kodas iš tiesų paleidžiamas iš pirmos eilutės, tačiau kiekvienai veiklai, kuri jau buvo baigta, variklis nebekviečia tavo funkcijos iš naujo. Vietoj to, jis panaudoja užfiksuotą rezultatą iš žurnalo. Workflow juda skaitymo greičiu, kol pasiekia pirmąją nebaigtą veiklą. Tik tada prasideda tikras darbas.

Veiklos, kurios jau buvo sėkmingai įvykdytos, perkartojimo metu niekada nevykdomos iš naujo. Toliau pateiktas pavyzdys padaro šią garantiją apčiuopiamą pačiu jautriausiu atveju: el. laiško siuntimu.

import mistralai.workflows as workflows

@workflows.activity()
async def send_email(recipient: str, content: str) -> dict:
    """Ši veikla įvykdoma tik vieną kartą,
    net jei workflow perkartojamas kelis kartus."""
    response = await email_service.send(recipient, content)
    return {"status": "sent", "id": response.id}

@workflows.workflow.define(name="notification_workflow")
class NotificationWorkflow:
    @workflows.workflow.entrypoint
    async def run(self, recipient: str) -> dict:
        # Jei workflow stringa PO el. laiško išsiuntimo,
        # laiškas perkartojimo metu NEBUS siunčiamas iš naujo.
        email_result = await send_email(recipient, "Jūsų ataskaita paruošta")

        # Workflow tęsiasi čia
        log_result = await log_notification(recipient, email_result)
        return log_result

Atsparumas klaidoms: dengiami scenarijai

Platforma tvarko keturių tipų incidentus nereikalaudama iš tavęs nė vienos kodo eilutės. Pirma, darbuotojo gedimas: „Python“ procesas staiga sustoja dėl atminties klaidos, kill signalo arba serverio perkrovimo. Kitas darbuotojas perima workflow tiksliai ten, kur jis sustojo. Antra, laikina tinklo klaida: API užklausa nepavyksta dėl laiko limito viršijimo. Pakartojimo politika automatiškai paleidžia veiklą iš naujo taikydama eksponentinį delsą, naudodama didėjančius laiko tarpus, kad nebūtų „bombarduojama“ sunkumų turinti tarnyba.

Trečia, tavo pačio kode esančios klaidos: veikloje išmesta išimtis (exception) kartojama nustatytą kartų skaičių pagal sukonfigūruotą politiką, prieš tai galutinai nepavykus. Ketvirta, laikinas trečiosios šalies tarnybos neprieinamumas. Čia efektas dramatiškas: jei partnerio API neveikia dešimt minučių, tavo naktinis konvejeris nebepavyksta. Laukiančios veiklos paleidžiamos iš naujo, kai tarnyba atsistato, ir apdorojimas baigiamas tik dešimčia minučių vėliau.

Determinizmo apribojimas

Perkartojimas turi savo kainą. Kad žurnalo perkartojimas tiksliai atkurtų originalų vykdymą, workflow kodas (ne veiklų) privalo būti deterministinis. Gavęs tuos pačius įvesties duomenis, jis turi sugeneruoti tą pačią operacijų seką. Jei tavo workflow šakojasi pagal sąlygą if datetime.now().hour < 12, perkartojimas šį vakarą gali pasirinkti kitą šaką ir visiškai išderinti žurnalą.

Todėl workflow kode niekada neturi daryti šių veiksmų:

  • Naudoti datetime.now() → naudok workflow.now()
  • Naudoti uuid.uuid4() → naudok workflow.uuid4()
  • Naudoti random.random() → naudok workflow.random()
  • Tiesiogiai vykdyti tinklo arba I/O užklausas → perkelti jas į veiklą

Šie trys pakaitalai grąžina reikšmes, užfiksuotas pirmojo praėjimo metu, ir vėliau jas identiškas perkartoja. Šį apribojimą detaliai nagrinėsime 8-oje pamokoje, skirtoje determinizmui.

Palyginimas su tradiciniais požiūriais

PožiūrisGedimų atkūrimasVykdymo garantijaSudėtingumas
Paprastas „Python“ scenarijusNėraNėraŽemas
Žinučių eilė („Celery“, „RQ“)DalinisBent vieną kartą (At-least-once)Vidutinis
„Cron“ + duomenų bazėRankinisPriklauso nuo implementacijosAukštas
Mistral Workflows (Temporal)AutomatinisTiksliai vieną kartą (logiškai)Žemas (SDK)

Atidžiai stebėk sudėtingumo stulpelį. Žinučių eilė atrodo paprasta pradedant, tačiau jos dalinis atkūrimas verčia rašyti būsenos valdymo logiką, kurią SDK suteikia „iš dėžutės“.

Tiksliai vieną kartą: loginė garantija

Platforma garantuoja, kad tavo workflow logika įvykdoma tiksliai vieną kartą. Jei veikla pavyksta, sistema įrašo rezultatą ir niekada jos nebevykdo iš naujo. Jei ji nepavyksta, sistema ją kartoja pagal sukonfigūruotą politiką.

Žodis „loginė“ nėra papuošalas. Tinklo lygmeniu užklausa gali būti išsiųsta dukart: tavo prašymas sukurti klientą pasiekia CRM, tačiau patvirtinimas dingsta kelyje. Tavo požiūriu, veikla nepavyko ir bus kartojama, nors klientas jau egzistuoja. Tai sukuria poreikį idempotentiškoms veikloms, kurios duoda tą patį rezultatą netgi jei yra iškviečiamos kelis kartus su tais pačiais parametrais. Praktiškai tai reiškia, kad geriau naudoti PUT su stabiliu ID, o ne POST, kuris kiekvieno iškvietimo metu sukuria naują eilutę.

Svarbiausi punktai

  • Įvykių šaltinis fiksuoja kiekvieną žingsnį kaip nekintamą įvykį žurnale
  • Automatinis perkartojimas leidžia tęsti nutrauktą workflow nevykdant baigtų veiklų iš naujo
  • Platforma automatiškai tvarko gedimus, tinklo klaidas ir tarnybų neveikumą
  • Workflow kodas privalo būti deterministinis, kad perkartojimas veiktų
  • Veiklos privalo būti idempotentiškos, kad būtų užtikrintas nuoseklumas kartojimų metu
  • Vykdymo garantija yra loginis „tiksliai vieną kartą“