inogen/deployment/UPDATE.md

11 lines
2.1 KiB
Markdown

# راهنمای سادهٔ به‌روزرسانی سامانه
این بسته فایل‌های تغییرکردهٔ برنامه و چهار DLL اصلی لازم برای بررسی یکپارچگی را در پوشه‌های `backend`، `frontend` و `tools` دارد. نام نسخهٔ قبلی در فایل `VERSION.txt` نوشته شده است؛ پیش از نصب، آن را با نسخهٔ نصب‌شده تطبیق دهید.
1. پیش از شروع، از پایگاه داده و کل پوشهٔ نصب سامانه نسخهٔ پشتیبان بگیرید. از سالم بودن نسخهٔ پشتیبان مطمئن شوید.
2. در IIS، سایت‌های فرانت و API و App Pool مربوط به API را متوقف کنید.
3. فایل ZIP به‌روزرسانی را استخراج کنید. محتوای هر یک از پوشه‌های موجود `backend`، `frontend` و `tools` را روی پوشهٔ هم‌نام در محل نصب کپی کنید. گزینهٔ جایگزینی فایل‌های هم‌نام را تأیید کنید. پوشه‌های مقصد را پاک نکنید و از گزینهٔ «همگام‌سازی با حذف فایل‌های اضافی» استفاده نکنید.
4. فایل‌های `appsettings.json`، `appsettings.Production.json`، `frontend/config/runtime-config.js` و کل پوشهٔ `backend/data` را نگه دارید. این فایل‌ها در بستهٔ به‌روزرسانی نیستند و تنظیمات و داده‌های محیط نصب را نگه می‌دارند.
5. اگر نسخهٔ جدید به تغییر ساختار دیتابیس نیاز دارد، اسکریپت `migrate-target.ps1` را از بستهٔ کامل همان نسخه طبق راهنمای نصب اجرا کنید. سپس سایت‌ها و App Pool را در IIS روشن کنید.
6. آدرس `/health` مربوط به API، صفحهٔ ورود، و یک بخش اصلی سامانه را بررسی کنید. اگر به‌روزرسانی موفق نبود، فایل‌ها و دیتابیس را از نسخهٔ پشتیبان برگردانید.