Angular

انگولار (Angular) یک فریم‌ورک توسعه وب متن‌باز و قدرتمند است که توسط گوگل برای ساخت برنامه‌های تک‌صفحه‌ای (SPA) و مقیاس‌پذیر طراحی شده است. این فریم‌ورک بر پایه TypeScript و معماری مبتنی بر کامپوننت (Component-based) ساخته شده و به توسعه‌دهندگان امکان می‌دهد وب‌اپلیکیشن‌هایی با کارایی بالا و رابط کاربری یکپارچه ایجاد کنند.

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

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

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

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

برای اینکه پروژه شما به درستی توسط موتور استقرار پارس‌پک شناسایی و دیپلوی شود، رعایت استانداردهای زیر در سورس‌کد و تنظیمات الزامی است:

  • عدم آپلود وابستگی‌ها: اکیدا از آپلود پوشه node_modules در سورس‌کد یا فایل زیپ خودداری کنید. این پوشه در مرحله بیلد به صورت خودکار توسط پلتفرم نصب می‌شود.

  • فایل‌های ساختاری الزامی: وجود سه فایل package.json، angular.json و tsconfig.json در مسیر ریشه اجرا (context_dir) کاملا اجباری است تا ابزار ساخت انگولار (Angular CLI) بتواند پروژه را کامپایل کند.

  • ساختار معتبر: محتوای package.json می‌بایست کاملا صحیح بوده و بخش scripts در آن برای فرایند بیلد پروداکشن تعریف شده باشد.

  • تخصیص منابع (Build Phase): اپلیکیشن‌های انگولار در مرحله کامپایل و بهینه‌سازی نهایی (AoT Compilation) نیازمند منابع پردازشی مناسبی هستند. سقف رم (RAM) و پردازنده (CPU) را متناسب با حجم کامپوننت‌های پروژه تخصیص دهید تا فرایند بیلد با موفقیت طی شود.

  • پارامترهای پایه: امکان تنظیم نسخه ران‌تایم (Node.js Version) و مسیر ریشه اجرای پروژه (angular_context_dir) در زمان استقرار از طریق پنل فراهم است.

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

متغیرهای محیطی در برنامه‌های تک‌صفحه‌ای (SPA) در زمان کامپایل (Build) به کدهای استاتیک خروجی تزریق می‌شوند. اگر پروژه خود را به صورت استاندارد توسعه داده‌اید، متغیرهای مورد نیاز را در پنل تنظیمات وارد کنید تا در پروسه کامپایل از طریق اسکریپت‌های ساخت یا ساختار پوشه environments/ به کدهای فرانت‌اِند تزریق شوند. در صورت استفاده از ساختار Angular SSR (رندر سمت سرور)، این متغیرها در زمان اجرا (Runtime) نیز در دسترس محیط وب‌سرور خواهند بود.

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

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

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

وب‌هوک

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

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

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