Přeskočit na obsah

Okamžitý restart LaunchAgentu může skončit chybou bootstrap

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

Instalační skript provede launchctl bootout a hned poté launchctl bootstrap. Druhý příkaz občas skončí obecnou vstupně-výstupní chybou. Ruční opakování stejného bootstrap příkazu o chvíli později projde bez změny plist souboru.

Odstranění jobu z launchd domény není vždy synchronní s okamžikem návratu bootout. Krátké okno může přetrvat i poté, co launchctl print už původní job nenajde. Jednorázový bootstrap proto zamění přechodný stav launchd za trvalou chybu konfigurace.

Terminál
launchctl bootout "$DOMAIN/$LABEL" 2>/dev/null || true
launchctl bootstrap "$DOMAIN" "$PLIST" # přechodně může selhat

Samotný bootstrap má bounded retry. Počet pokusů i prodleva jsou pevné; nekonečná smyčka není přípustná. Po vyčerpání limitu skript vrátí odlišný chybový kód a službu neprohlásí za spuštěnou.

Terminál
attempts=20
while ! launchctl bootstrap "$DOMAIN" "$PLIST"; do
attempts=$((attempts - 1))
[ "$attempts" -gt 0 ] || exit 3
sleep 0.1
done

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: Hledej instalační skripty s bootout následovaným jediným bootstrap bez bounded retry.
  • Anti-pattern: Pevný dlouhý sleep nebo nekonečné opakování bez rozlišení trvalé chyby.
  • Lepší přístup: Krátký bounded retry pouze kolem přechodně selhávající operace; plist nejdřív samostatně ověřit pomocí plutil.

Sister bugs / související

Sekce “Sister bugs / související”

Podobný vzor se objevuje při restartu systemd jednotek nebo výměně socket listeneru: řídicí příkaz se vrátí dřív, než je interní životní cyklus plně uzavřen. Oprava musí být omezená počtem pokusů a nesmí maskovat trvalou chybu konfigurace.

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