Flask

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

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

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

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

برای اینکه اپلیکیشن شما به درستی توسط موتور پایتون/فلسک پارس‌پک شناسایی و کامپایل شود، رعایت این استانداردهای زیرساختی الزامی است:

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

  • فایل‌های سورس‌کد: حداقل یک فایل با فرمت .py باید در مسیر context_dir وجود داشته باشد.

  • پورت اجرای برنامه: پورت پیش‌فرض پنل برای برنامه‌های فلسک 5000 است. اطمینان حاصل کنید که این عدد با پورت اجرایی کدهای شما برای Listen کردن ترافیک، تطابق کامل دارد.

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

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

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

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

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

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

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

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

وب‌هوک

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

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

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