استقراری که با git pull روی پوشهٔ زنده انجام شود، چند ثانیهای سایت را در حالت نیمهکاره میگذارد: بعضی فایلها نو و بعضی کهنه. اگر npm ci یا composer install وسطش شکست بخورد، سایت همانطور میماند.
الگوی زیر این را حل میکند و بازگشت را هم تقریباً آنی.
ساختار پوشه
/srv/myapp/
├── releases/
│ ├── 2026-10-09-141205/
│ ├── 2026-10-10-093011/
│ └── 2026-10-11-100233/
├── shared/
│ ├── .env
│ ├── storage/
│ └── uploads/
└── current -> releases/2026-10-11-100233
وبسرور به current اشاره میکند، که یک پیوند نمادین است. نسخهٔ تازه در پوشهٔ خودش ساخته میشود و تا لحظهٔ آخر دست نمیخورد.
shared/ چیزهایی است که بین نسخهها مشترکاند: فایل محیطی، آپلودها، فضای موقت. اینها نباید با هر استقرار از نو بسازند.
اسکریپت
#!/usr/bin/env bash
set -euo pipefail
APP=/srv/myapp
REPO=git@github.com:you/myapp.git
KEEP=5
REL="$APP/releases/$(date +%Y-%m-%d-%H%M%S)"
echo "» گرفتن کد"
git clone --depth 1 --branch main "$REPO" "$REL"
echo "» وصل کردن فایلهای مشترک"
ln -sfn "$APP/shared/.env" "$REL/.env"
rm -rf "$REL/storage" "$REL/public/uploads"
ln -sfn "$APP/shared/storage" "$REL/storage"
ln -sfn "$APP/shared/uploads" "$REL/public/uploads"
echo "» نصب و ساخت"
cd "$REL"
npm ci --omit=dev
npm run build
echo "» بررسی سلامت نسخهٔ تازه"
node "$REL/scripts/healthcheck.js"
echo "» سوئیچ"
ln -sfn "$REL" "$APP/current.new"
mv -Tf "$APP/current.new" "$APP/current"
sudo systemctl reload myapp
echo "» پاک کردن نسخههای قدیمی"
cd "$APP/releases"
ls -1t | tail -n +$((KEEP + 1)) | xargs -r rm -rf
echo "تمام: $(basename "$REL")"
چند خط که ظاهرشان ساده است و نیستند:
mv -Tf بهجای ln -sfn مستقیم. اگر پیوند را مستقیم روی current بازنویسی کنی، در یک کسری از ثانیه پوشه وجود ندارد و درخواستی که همان لحظه برسد خطا میگیرد. ساختن پیوند با نام دیگر و بعد mv روی مقصد، در لینوکس یک عملیات اتمی است: یا نسخهٔ قدیم است یا جدید، هیچوقت هیچکدام.
بررسی سلامت پیش از سوئیچ. اگر نسخهٔ تازه بالا نمیآید، همینجا اسکریپت میایستد و current دستنخورده میماند. سایت هنوز با نسخهٔ قبلی کار میکند و تو وقت داری بفهمی چه شده.
reload نه restart. برای php-fpm و nginx، ریلود پروسههای در حال کار را تمام میکند و بعد عوضشان میکند. ریاستارت وسط کار قطعشان میکند.
برگشت
#!/usr/bin/env bash
set -euo pipefail
APP=/srv/myapp
PREV=$(ls -1t "$APP/releases" | sed -n 2p)
[ -n "$PREV" ] || { echo "نسخهٔ قبلی نیست"; exit 1; }
ln -sfn "$APP/releases/$PREV" "$APP/current.new"
mv -Tf "$APP/current.new" "$APP/current"
sudo systemctl reload myapp
echo "برگشت به $PREV"
چند ثانیه طول میکشد، چون چیزی ساخته نمیشود؛ فقط یک پیوند عوض میشود.
مهاجرت پایگاه داده
تنها بخشی که این الگو خودش حل نمیکند. مهاجرتی که ستونی را حذف کند، نسخهٔ قبلی را میشکند و برگشت دیگر کار نمیکند.
قاعدهای که عملاً جواب میدهد: مهاجرتها را سازگار با نسخهٔ قبل بنویس. ستون تازه اضافه کن ولی قدیمی را در همان استقرار حذف نکن. حذف را به استقرار بعدی بسپار، وقتی مطمئن شدی برنمیگردی.
تنظیم nginx
root /srv/myapp/current/public;
و یک نکته: در بعضی نسخهها nginx مسیر واقعی پیوند را کش میکند و بعد از سوئیچ، همچنان به پوشهٔ قدیمی نگاه میکند. اگر دیدی reload کافی نیست، این را اضافه کن:
disable_symlinks off;
و برای php-fpm، در php.ini:
opcache.revalidate_path=1
بدون این، OPcache مسیر حلشدهٔ قبلی را نگه میدارد و کد قدیمی اجرا میشود در حالی که فایلها عوض شدهاند. یکی از گیجکنندهترین خطاهایی است که در این الگو پیش میآید.