Node.js

نودجی‌اس (Node.js) یک پلتفرم بر پایه جاوا اسکریپت است که برای ساخت برنامه‌های شبکه‌ای سریع و مقیاس‌پذیر طراحی شده است. این محیط اجرا به توسعه‌دهندگان این امکان را می‌دهد تا با استفاده از جاوا اسکریپت، برنامه‌های سمت سرور بسازند و از مزایای معماری غیرهمزمان و مبتنی بر رویداد بهره‌مند شوند. نودجی‌اس به دلیل سرعت بالا و کارایی در پردازش درخواست‌های هم‌زمان، به ویژه در توسعه وب و برنامه‌های تحت وب محبوبیت زیادی دارد. همچنین، اکوسیستم غنی ماژول‌ها و بسته‌های موجود در npm، فرایند توسعه را تسهیل می‌کند.

در زیرساخت ابری پارس‌پک، شما می‌توانید برنامه‌های نودجی‌اس خود را بدون نیاز به درگیری با پیکربندی‌های پیچیده سرور، در یک محیط ایزوله و پایدار مستقر کنید.

توجه: برای استقرار فریم‌ورک‌ها و کتابخانه‌های فرانت‌اند مانند Next.js، Nuxt.js، React یا Vue.js، از پلتفرم‌های اختصاصی آن‌ها استفاده کنید و پروژه را روی پلتفرم خام Node.js مستقر نکنید.

مراحل استقرار

برای آموزش گام‌به‌گام ساخت اپلیکیشن، به راهنمای «استقرار از طریق سورس‌کد (زبان‌ها)» مراجعه کنید. همچنین برای تنظیمات زیرساختی نیز به بخش مدیریت اپلیکیشن مراجعه کنید:

پیش‌نیازها و استقرار کد

برای اجرای بدون خطای اپلیکیشن در محیط کانتینر، کدهای شما باید از قوانین زیر پیروی کنند:

  • پورت اجرای برنامه: پورت پیش‌فرض برای برنامه‌های Node.js در پارس‌پک 3000 است. وب‌سرور شما (در هر فریم‌ورکی که هستید) باید ترافیک را دقیقا روی این پورت Listen کند.

  • فایل اصلی: وجود حداقل یک فایل با پسوند .js در مسیر ریشه اجرا (context_dir) ضروری است.

  • فایل package.json: ساختار این فایل باید کاملا معتبر (Valid JSON) باشد. اسکریپت start در بخش scripts الزامی است، زیرا استقرار برنامه در سرور با اجرای این دستور انجام می‌شود (نمونه: "start": "node app.js").

  • مدیریت نسخه‌ها: تغییر نسخه ران‌تایم (Node Version) به سادگی از طریق پنل داشبورد قابل انجام است.

متغیرهای محیطی (Env Vars)

برای حفظ امنیت، کلیدهای API و اطلاعات حساس دیتابیس را هرگز در سورس‌کد هاردکد نکنید. این مقادیر را از طریق داشبورد پارس‌پک وارد نمایید. پس از تنظیم، این متغیرها به صورت بومی در سراسر کدهای شما به این شکل در دسترس هستند:

const dbHost = process.env.DB_HOST;
const apiKey = process.env.API_KEY;

نکته: برای آموزش گام‌به‌گام نحوه تعریف متغیرهای اختصاصی، ConfigMapها و Secretها در داشبورد، به مستندات متغیرهای محیطی مراجعه کنید.

تنظیمات دامنه

جهت اختصاص دامنه شخصی به سرویس نود جی‌اس خود برای دسترسی عمومی کاربران، به راهنمای تنظیمات دامنه و IP مراجعه کنید.

وب‌هوک

جهت پیاده‌سازی اتوماسیون و دیپلوی خودکار کدهای جدید با هر بار Push در مخزن گیت، مستندات وب‌هوک را بررسی کنید.

مشاهده لاگ‌ها

خروجی‌های استاندارد برنامه (مانند دستورات console.log یا ارورهای اجرایی) به‌صورت یکپارچه مانیتور می‌شوند. برای عیب‌یابی اپلیکیشن خود به مستندات لاگ‌ها مراجعه نمایید.