Next.js
فریمورک Next.js قدرتمندترین ابزار مبتنی بر React برای توسعه وباپلیکیشنهای سریع با قابلیت رندر سمت سرور (SSR) و تولید سایتهای ایستا (SSG) است. پلتفرم ابری پارسپک محیطی را فراهم کرده تا کدهای شما به صورت خودکار بیلد شده و وبسرور نود جیاس داخلی Next.js بدون نیاز به کانفیگهای پیچیده در محیط کانتینر اجرا شود.
مراحل استقرار
برای آموزش گامبهگام ساخت اپلیکیشن، به راهنمای «استقرار از طریق سورسکد (زبانها)» مراجعه کنید. همچنین برای تنظیمات زیرساختی نیز به بخش مدیریت اپلیکیشن مراجعه کنید:
پیشنیازها و استقرار کد
برای اینکه پروژه شما به درستی توسط موتور استقرار پارسپک شناسایی و بیلد شود، رعایت استانداردهای زیر در سورسکد الزامی است:
-
فایل وابستگیها: فایل
package.jsonباید حتما در مسیر ریشه اجرا (context_dir) وجود داشته باشد. -
ساختار معتبر: محتوای
package.jsonمیبایست کاملا صحیح بوده و بخشscriptsدر آن برای فرایندهای بیلد و اجرا به درستی تعریف شده باشد. -
پورت اجرای برنامه: پورت پیشفرض پنل برای برنامههای Next.js عدد
3000است. پورتی که وبسرور داخلی Next.js روی آن اجرا میشود، باید دقیقا با پورتی که در تنظیمات پنل وارد میکنید برابر باشد. در صورت وجود هرگونه مغایرت پورت، کانتینر ترافیک را دریافت نکرده و با خطا مواجه میشوید. -
پارامترهای پایه: امکان تغییر نسخه رانتایم (Node.js Version) و مسیر ریشه اجرای کد (context_dir) در زمان استقرار فراهم است.
متغیرهای محیطی (Env Vars)
متغیرهای محیطی برای مدیریت رفتار برنامه و حفظ امنیت دادهها استفاده میشوند. در Next.js این متغیرها به دو دسته تقسیم میشوند که باید هر دو را در پنل داشبورد تنظیم کنید:
-
متغیرهای سمت سرور: مقادیر حساس (مانند
DATABASE_URLیا توکنها) که فقط در محیط سرور در دسترس هستند. -
متغیرهای سمت کلاینت: متغیرهایی که باید در مرورگر کاربر هم در دسترس باشند. این متغیرها حتما باید با پیشوند
NEXT_PUBLIC_شروع شوند تا در پروسه Build و Runtime به درستی در کانتینر تزریق و خوانده شوند.
نکته: برای آموزش گامبهگام نحوه تعریف متغیرهای اختصاصی، ConfigMapها و Secretها در داشبورد، به مستندات
تنظیمات دامنه
جهت اختصاص دامنه شخصی به سرویس خود برای دسترسی عمومی کاربران، به راهنمای
وبهوک
جهت پیادهسازی اتوماسیون و دیپلوی خودکار کدهای جدید با هر بار Push در مخزن گیت،
مشاهده لاگها
خروجیهای استاندارد برنامه (مانند دستورات console.log یا ارورهای اجرایی) بهصورت یکپارچه مانیتور میشوند. برای عیبیابی اپلیکیشن خود به