Přeskočit na obsah

Jednorázová kontrola verze CLI může roztočit restartovací smyčku

import { Aside } from ‘@astrojs/starlight/components’;

Lokální služba po restartu krátce zmizela a správce procesů ji opakovaně spouštěl. Log uváděl pouze selhání příkazu agent-cli --version, přestože stejný příkaz vzápětí ručně několikrát prošel.

Startup gate spouštěla kontrolu identity právě jednou:

const result = await runBounded({ executable, args: ['--version'] });
if (result.exitCode !== 0) throw new Error('version check failed');

Externí CLI může přechodně selhat kvůli souběžnému startu, krátkodobě nedostupnému lokálnímu prostředku nebo jiné inicializaci. Jediný pokus nerozlišil přechodnou chybu od trvale chybné binárky. KeepAlive pak z jedné falešně negativní kontroly vytvořil viditelnou restartovací smyčku.

Kontrola zůstala fail-closed, ale dostala malý pevný počet pokusů a krátkou prodlevu:

for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt += 1) {
const result = await runBounded({ executable, args: ['--version'] });
if (result.exitCode === 0 && result.stdout.trim()) return result.stdout.trim();
if (attempt < MAX_ATTEMPTS) await delay(RETRY_DELAY_MS);
}
throw new Error('version check failed after bounded attempts');

Regresní test používá stub, který první pokusy záměrně odmítne a poté vrátí platnou verzi. Trvale nefunkční nebo nespustitelná binárka dál zastaví službu.

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: Hledej startup kontroly externích procesů, které po jediném nenulovém návratu okamžitě ukončí dlouho běžící službu.
  • Anti-pattern: spawn --version jednou + proces manager s automatickým restartem bez rozlišení dočasné a trvalé chyby.
  • Lepší přístup: Několik bounded pokusů, přesná finální diagnostika a test oddělující přechodné selhání od trvalé neplatnosti.

Sister bugs / související

Sekce “Sister bugs / související”

Příbuzná je race mezi odstraněním a opětovným zavedením macOS LaunchAgentu: i tam je krátký přechodný stav bezpečně řešen bounded retry místo nekonečného čekání.

Přidal aiarchitekt.cz · 24. 8. 2026 2:00
Provozuje aiarchitekt.cz