FastAPI
فست ای پی آی (FastAPI) یکی از مدرنترین و سریعترین فریمورکهای پایتون برای ساخت رابطهای برنامهنویسی کاربردی (API) است. این فریمورک کاملا بر پایه استانداردهای نوعدهی (Type Hints) پایتون توسعه یافته و با ساختار مهندسی خود، سرعت توسعه سیستمها را بین ۲۰۰ تا ۳۰۰ درصد افزایش میدهد. تمرکز اصلی فست ای پی آی بر پرفورمنس بسیار بالا و کاهش باگهای نرمافزاری در زمان توسعه است.
پلتفرم ابری پارسپک زیرساختی ایزوله و کاملا بهینه برای اجرای کدهای پایتون فراهم کرده است. با استفاده از این بستر، دغدغههای مربوط به پیکربندی وبسرورهای پایتونی (مانند Uvicorn) حذف شده و اپلیکیشن شما با حداکثر سرعت، بدون نیاز به مدیریت سرور، روی کانتینرهای ابری مستقر میشود.
مراحل استقرار
برای آموزش گامبهگام ساخت اپلیکیشن، به راهنمای «استقرار از طریق سورسکد (زبانها)» مراجعه کنید. همچنین برای تنظیمات زیرساختی نیز به بخش مدیریت اپلیکیشن مراجعه کنید:
پیشنیازها و استقرار کد
برای اینکه موتور استقرار پارسپک پروژه شما را به درستی تشخیص داده و بیلد کند، رعایت استانداردهای زیر در سورسکد الزامی است:
-
فایل وابستگیها: فایل
requirements.txt(حاوی لیست کتابخانهها و وابستگیهای پایتون) باید حتما در مسیر ریشه اجرا (context_dir) وجود داشته باشد. -
فایل اجرایی اصلی: فایل اصلی برنامه با نام دقیق
main.pyباید حتما در مسیر ریشه اجرا (context_dir) قرار داشته باشد تا نقطه شروع اجرای وبسرور مشخص باشد. -
پورت اجرای برنامه: پورت پیشفرض پنل برای پروژههای فست ای پی آی روی 8000 تنظیم شده است. اطمینان حاصل کنید که پورت اجرایی در سورسکد شما (تنظیمات وبسرور داخلی) با این عدد تطابق کامل دارد.
-
دستور اجرا (Start Command): در صورت نیاز به تعیین دستور خاصی برای اجرای کانتینر (مانند تنظیم تعداد Workerها یا فلگهای خاص در Uvicorn)، میتوانید دستور سفارشی خود را در این بخش وارد کنید.
-
پارامترهای پایه: امکان تغییر مسیر ریشه اجرای پروژه و تنظیم پورت متناسب با معماری کدهای شما در پنل فراهم است.
متغیرهای محیطی (Env Vars)
متغیرهای محیطی برای مدیریت رفتار برنامه و حفظ امنیت دادهها استفاده میشوند. اطلاعات حساسی مانند آدرس دیتابیس یا کلیدهای امنیتی را در داشبورد وارد کنید تا در زمان اجرا به صورت امن در دسترس کانتینر قرار گیرند.
شما میتوانید این مقادیر را در کدهای خود، از طریق ماژول استاندارد os و تابع os.getenv() یا با استفاده از ابزارهای مدیریت کانفیگ فریمورک مانند Pydantic Settings به صورت کاملا امن فراخوانی کنید.
نکته: برای آموزش گامبهگام نحوه تعریف متغیرهای اختصاصی، ConfigMapها و Secretها در داشبورد، به مستندات
تنظیمات دامنه
جهت اختصاص دامنه شخصی به سرویس خود برای دسترسی عمومی کاربران، به راهنمای
وبهوک
جهت پیادهسازی اتوماسیون و دیپلوی خودکار کدهای جدید با هر بار Push در مخزن گیت،
مشاهده لاگها
خروجیهای استاندارد برنامه و ارورهای زمان اجرا بهصورت یکپارچه مانیتور میشوند. برای عیبیابی اپلیکیشن خود به