Python

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

در پلتفرم ابری پارس‌پک، برنامه‌های مبتنی بر پایتون در یک محیط کانتینری ایزوله و بومی اجرا می‌شوند. موتور استقرار (Build Engine) ما با شناسایی خودکار فایل requirements.txt، تمامی وابستگی‌های پروژه را نصب کرده و برنامه شما را برای پردازش ترافیک پروداکشن آماده می‌کند.

توجه:

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

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

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

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

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

  • فایل وابستگی‌ها: وجود فایل requirements.txt در مسیر ریشه اجرا (context_dir) الزامی است. استقرار بدون این فایل با خطا مواجه خواهد شد.

  • پورت اجرای برنامه: پورتی که در تب تنظیمات داشبورد وارد می‌کنید، باید دقیقا با پورتی که در فایل اصلی پایتون (مثلا در تنظیمات وب‌سرور داخلی) برای Listen کردن ترافیک تعریف کرده‌اید، یکسان باشد.

  • فایل اجرایی پیش‌فرض: پارس‌پک به صورت پیش‌فرض برای اجرای برنامه به دنبال فایلی به نام app.py می‌گردد. اگر فایل اصلی برنامه شما نام دیگری دارد، باید آن را به سیستم معرفی کنید (به بخش متغیرهای محیطی مراجعه کنید).

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

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

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

  • معرفی فایل اصلی (APP_FILE): اگر فایل اصلی اجرای برنامه شما نامی غیر از app.py دارد (مانند main.py یا server.py)، باید یک متغیر محیطی جدید ایجاد کنید؛ در فیلد کلید، عبارت APP_FILE و در فیلد مقدار، نام فایل اجرایی خود را وارد کنید تا موتور استقرار آن را اجرا کند.

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

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

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

وب‌هوک

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

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

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