Souběžný deploy dvou operátorů — rsync přepsal zdroje během cizího buildu, oba buildy spadly na ENOENT
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Dva lidé spustili deploy téže aplikace minutu po sobě. Oba běhy skončily
BUILD FAILED s chybou typu:
Error: ENOENT: no such file or directory, open '<app>/.next-build/static/<id>/_ssgManifest.js'Error: ENOENT: no such file or directory, open '<app>/.next-build/server/pages-manifest.json'Živá verze běžela dál beze změny (build šel do .next-build a do .next
se přepíná až po úspěchu). Z logu to vypadalo jako rozbitý build, ve
skutečnosti šlo o souběh.
Root cause
Sekce “Root cause”Deploy řetěz: lokální gaty → rsync --delete zdrojáků na server → serverový
skript (flock na zámkový soubor → build do .next-build → migrace → swap →
restart). Zámek se bral až na serveru, takže:
- Operátor A: rsync hotový, serverový build běží (drží zámek).
- Operátor B: lokální gaty projdou, rsync přepíše zdrojáky a smaže soubory v app adresáři, zatímco A buildí z téhož stromu → A spadne na chybějících souborech.
- B dorazí na server až po pádu A (zámek volný), ale
.next-buildje po A v nekonzistentním stavu / strom se změnil pod rukama → B spadne taky.
Zámek chránil jen část řetězu; první nevratný zásah (rsync) byl mimo něj.
Fix
Sekce “Fix”# lokální wrapper, PŘED rsyncem — neblokující test téhož zámku, který drží serverif ! ssh "$HOST" "flock -n $APP_DIR/.deploy.lock true"; then echo "STOP: na serveru běží jiný deploy." >&2; exit 4firsync -az --delete … "$HOST:$APP_DIR"ssh "$HOST" "$APP_DIR/scripts/server/deploy.sh" # tady flock -n znovu, kryje build → swapMezi testem a serverovým flock zůstává úzké okno; úplně těsné řešení je
rsync do staging adresáře (releases/<ts>) a přepnutí symlinku, které už
zámek drží celé.
Jak to poznat příště
Sekce “Jak to poznat příště”ENOENTna vlastní výstupní soubory buildu (*manifest*.js,pages-manifest.json) = někdo sahal do adresáře během buildu, ne chyba kódu.- V deploy logu dva
DEPLOY STARTbezDONEmezi nimi. - Před opakováním ověř, že neběží jiný
next build/ deploy proces.
Test
Sekce “Test”Dva deploye spuštěné 30 s po sobě: druhý skončí hned STOP: na serveru běží jiný deploy, první doběhne a provede swap; produkce nikdy neodpovídá chybou.