Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Odolnosť a spoľahlivosť workflow

Lekcia 2 z 14 Aktualizované 29. júla 2026 Pokročilý
Na tejto strane
  1. Prečo odolnosť mení všetko
  2. Event sourcing: Hlavný princíp
  3. Automatické prehrávanie: Obnova po zlyhaní
  4. Odolnosť voči chybám: Pokryté scenáre
  5. Obmedzenie determinizmu
  6. Porovnanie s tradičnými prístupmi
  7. Presne raz: Logická záruka
  8. Kľúčové poznatky

Prečo odolnosť mení všetko

Predstav si desaťkrokový pipeline spracúvajúci dávku faktúr: extrakcia, validácia, volanie modelu, zápis do databázy, notifikácia. V bežnom Pythone skripte ťa chyba v kroku 7 donúti vrátiť sa na krok 1. Prvých šesť krokov sa spustí znova, čo vytvorí vážne problémy, ak ktorýkoľvek z nich už zapisoval do databázy alebo odoslal správu. Pri odolnom workflow systém pokračuje presne v kroku 7. Preskočí prvých šesť krokov, vyhne sa duplikácii akcií a nestratí žiadne dáta.

Táto schopnosť stojí na konkrétnom mechanizme nazývanom event sourcing. Pochopenie tohto konceptu je kľúčové, pretože vysvetľuje obmedzenia, s ktorými sa neskôr stretneš.

Event sourcing: Hlavný princíp

Event sourcing zaznamenáva každú akciu workflow ako nemeniteľnú udalosť (immutable event) v logu. Rozdiel oproti tradičnému prístupu sa dá vyjadriť jednou vetou: namiesto ukladania iba aktuálneho stavu (napr. „prebieha, krok 7“) platforma uchováva kompletnú históriu operácií a ich výsledkov. Vykonanie workflow s dvoma aktivitami zanechá nasledujúcu stopu:

  1. Workflow sa spustí a prijme vstupné parametre → udalosť zaznamenaná
  2. Workflow zavolá aktivitu A → udalosť zaznamenaná
  3. Aktivita A sa dokončí s výsledkom → udalosť zaznamenaná
  4. Workflow zavolá aktivitu B → udalosť zaznamenaná
  5. Aktivita B sa dokončí → udalosť zaznamenaná
  6. Workflow vráti svoj konečný výsledok → udalosť zaznamenaná

Systém trvalo uloží každý krok predtým, než prejde na ďalší. Neexistuje žiadne okno, v ktorom by sa akcia vykonala bez toho, aby o tom log vedel. Tento log sa stáva jediným zdrojom pravdy; stav workflow neexistuje nikde inde.

Automatické prehrávanie: Obnova po zlyhaní

Keď worker spadne, nový worker prevezme kontrolu, stiahne log udalostí a prehrá kód workflow od začiatku. Slovo „prehrávanie“ ľudí často prekvapí: kód sa naozaj reštartuje od prvého riadku, ale pre každú aktivitu, ktorá sa už dokončila, engine znova nezavolá tvoju funkciu. Namiesto toho dosadí zaznamenaný výsledok z logu. Workflow postupuje rýchlosťou čítania, kým nenarazí na prvú nedokončenú aktivitu. Až vtedy sa obnoví skutočná práca.

Aktivity, ktoré už úspešne skončili, sa počas prehrávania nikdy nevykonajú znova. Nasledujúci príklad robí túto záruku hmatateľnou pre najcitlivejší prípad: odoslanie e-mailu.

import mistralai.workflows as workflows

@workflows.activity()
async def send_email(recipient: str, content: str) -> dict:
    """Táto aktivita sa spustí len raz,
    aj keď sa workflow viackrát prehrá."""
    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:
        # Ak workflow spadne PO odoslaní e-mailu,
        # e-mail sa počas prehrávania NEODOŠLE znova.
        email_result = await send_email(recipient, "Vaša správa je pripravená")

        # Workflow tu pokračuje
        log_result = await log_notification(recipient, email_result)
        return log_result

Odolnosť voči chybám: Pokryté scenáre

Platforma zvláda štyri typy incidentov bez toho, aby si musel napísať jediný riadok kódu. Po prvé, pád workeru: Python proces sa náhle zastaví kvôli chybe pamäte, signálu kill alebo reštartu servera. Iný worker prevezme workflow presne tam, kde skončilo. Po druhé, prechodná chyba siete: volanie API zlyhá kvôli časovému limitu. Politika opakovania automaticky reštartuje aktivitu s exponenciálnym oneskorením (exponential backoff), pričom používa rastúce oneskorenia, aby nezaťažovala službu, ktorá má problémy.

Po tretie, chyby v tvojom vlastnom kóde: výnimka vyvolaná v aktivite sa opakuje definovaný početkrát na základe nastavenej politiky, kým trvalo nezlyhá. Po štvrté, dočasná nedostupnosť služby tretej strany. Účinok je tu dramatický: ak partnerské API vypadne na desať minút, tvoj nočný pipeline už nezlyhá. Čakajúce aktivity sa reštartujú, keď sa služba vráti, a spracovanie sa dokončí len o desať minút neskôr.

Obmedzenie determinizmu

Prehrávanie má svoju cenu. Aby log verné reprodukoval pôvodné vykonanie, kód workflow (nie aktivít) musí byť deterministický. Pri rovnakých vstupoch musí produkovať rovnakú postupnosť operácií. Ak sa tvoje workflow vetví na základe if datetime.now().hour < 12, prehrávanie dnes večer môže ísť inou vetvou, čo úplne rozhodí synchronizáciu s logom.

Preto v kóde workflow nikdy nerob nasledovné:

  • Nepoužívaj datetime.now() → použi workflow.now()
  • Nepoužívaj uuid.uuid4() → použi workflow.uuid4()
  • Nepoužívaj random.random() → použi workflow.random()
  • Nerob priame volania siete alebo I/O → presuň ich do aktivity

Tieto tri substitúcie vracajú hodnoty zaznamenané počas prvého prechodu a následne ich identicky prehrávajú. Toto obmedzenie podrobne rozoberieme v lekcii 8, ktorá sa zameriava na determinizmus.

Porovnanie s tradičnými prístupmi

PrístupObnova po zlyhaníZáruka vykonaniaZložitosť
Jednoduchý Python skriptNieŽiadnaNízka
Fronta správ (Celery, RQ)ČiastočnáAspoň raz (At-least-once)Stredná
Cron + DatabázaManuálnaZávisí od implementácieVysoká
Mistral Workflows (Temporal)AutomatickáPresne raz (logicky)Nízka (SDK)

Venuj veľkú pozornosť stĺpcu zložitosť. Fronta správ sa na začiatku zdá jednoduchá, ale jej čiastočná obnova ťa núti písať logiku správy stavu, ktorú SDK poskytuje priamo z krabice.

Presne raz: Logická záruka

Platforma garantuje, že logika tvojho workflow sa vykoná presne raz. Ak sa aktivita úspešne dokončí, systém zaznamená výsledok a nikdy ju znova nevykoná. Ak zlyhá, systém ju opakuje podľa nastavenej politiky.

Slovo „logicky“ nie je len ozdobné. Na úrovni siete sa volanie môže skutočne odoslať dvakrát: tvoja požiadavka na vytvorenie zákazníka dorazí do CRM, ale potvrdenie sa cestou stratí. Z tvojho pohľadu aktivita zlyhala a bude sa opakovať, hoci zákazník už existuje. To si vyžaduje idempotentné aktivity, ktoré produkujú rovnaký výsledok aj pri viacnásobnom zavolaní s rovnakými parametrami. V praxi to znamená uprednostniť PUT na stabilnom ID pred POST, ktorý pri každom volaní vytvorí nový riadok.

Kľúčové poznatky

  • Event sourcing zaznamenáva každý krok ako nemeniteľnú udalosť v logu
  • Automatické prehrávanie ti umožňuje obnoviť prerušené workflow bez opätovného vykonania dokončených aktivít
  • Platforma automaticky rieši pády, chyby siete a výpadky služieb
  • Kód workflow musí byť deterministický, aby prehrávanie fungovalo
  • Aktivity musia byť idempotentné, aby sa zabezpečila konzistencia pri opakovaní
  • Záruka vykonania je logicky presne raz