Golang (Go)

زبان Go (گولنگ) به دلیل معماری مبتنی بر کامپایل و مدیریت بی‌نظیر هم‌زمانی (Goroutines)، انتخاب اول توسعه‌دهندگان برای ساخت میکروسرویس‌ها و APIهای پرترافیک است. پلتفرم ابری پارس‌پک با درک این معماری، محیطی را فراهم کرده تا سورس‌کد شما بدون نیاز به درگیری با تنظیمات سرور، به یک باینری بهینه‌شده و آماده‌ی اجرا در کانتینر تبدیل شود.

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

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

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

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

• فایل مدیریت وابستگی‌ها: فایل go.mod باید حتما در مسیر ریشه اجرا (context_dir) وجود داشته باشد.

• سورس‌کد اصلی: باید حداقل یک فایل با فرمت .go در مسیر ریشه قرار داشته باشد تا موتور بیلد بتواند نقطه شروع برنامه (پکیج main) را پیدا کند.

• پورت اجرای برنامه: اپلیکیشن‌های Go در پارس‌پک به صورت پیش‌فرض بر روی پورت 8080 بیلد و اجرا می‌شوند. پورتی که در سورس‌کد شما (مثلا در متد ListenAndServe) تعریف شده، باید دقیقا با پورتی که در مرحله تنظیمات پنل وارد می‌کنید برابر باشد؛ در غیر این صورت، اپلیکیشن شما در محیط کانتینر قادر به دریافت ترافیک نخواهد بود.

• ممنوعیت پورت‌های سیستمی: به دلیل محدودیت‌های امنیتی کلاستر، استفاده از پورت‌های زیر 1000 (مانند 80 یا 443) در داخل کانتینر مجاز نیست.

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

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

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

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

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

وب‌هوک

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

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

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