هاست Flask با gunicorn

Flask، کوچک و آماده

اگر Procfile نباشد، wsgi.py و بعد app.py و main.py بررسی می‌شوند و gunicorn با دو worker روی پورت اپ اجرا می‌شود. بنابراین یک اپ Flask ساده بدون هیچ تنظیمی بالا می‌آید.

سرور توسعه‌ی Flask (flask run) برای تولید مناسب نیست. gunicorn را به وابستگی‌ها اضافه کنید و اگر درخواست‌های طولانی دارید، timeout را در Procfile بالا ببرید.

مسیر بیلد Flask

1. تشخیص

   فایل وابستگی‌ها و app.py یا wsgi.py.

   app.py

2. نصب

   وابستگی‌ها با ابزار پروژه نصب می‌شوند.

   pip install -r requirements.txt

3. اجرا

   gunicorn شیء app را با دو worker اجرا می‌کند.

   gunicorn app:app

خروجی یک استقرار واقعی

$ sakoocloud deploy
✔ Packed 0.2MB
✔ Source uploaded
ℹ Build started · dep_7k2m9q
#4 [build 1/5] FROM python:3.12-slim
#6 [build 3/5] RUN pip install -r requirements.txt
#8 [build 4/5] COPY . .
#10 exporting to image
✔ Deployed — app is running.
→ https://my-flask.sakooapps.ir

کمترین چیزی که لازم دارید

gunicorn را به وابستگی‌ها اضافه کنید؛ Procfile اختیاری است ولی رفتار را صریح می‌کند.

from flask import Flask, jsonify

app = Flask(__name__)


@app.get("/health")
def health():
    return jsonify(ok=True)

web: gunicorn app:app --bind 0.0.0.0:$PORT --workers 2 --timeout 60

flask==3.*
gunicorn==23.*

تنظیمات

اتصال به دیتابیس

بعد از لینک کردن دیتابیس، DATABASE_URL در محیط اپ است و ORM ها مستقیم از آن استفاده می‌کنند.

sakoocloud apps link-db <db-id> --app my-api

import os
from sqlalchemy import create_engine

engine = create_engine(os.environ["DATABASE_URL"])

همراه هر استقرار

این‌ها به رانتایم بستگی ندارند و برای هر اپ روی سکو کلود فعال‌اند. بعضی، مثل مقیاس‌دهی خودکار و کران‌جاب، به پلن بستگی دارند.

• دامنه‌ی اختصاصی و SSLدامنه را اضافه کنید؛ گواهی خودکار صادر و تمدید می‌شود.
• متغیرهای محیطی و سکرتمقادیر رمزگذاری‌شده فقط در زمان اجرا به اپ می‌رسند.
• مرحله‌ی انتشارmigration بعد از بیلد و پیش از جایگزینی نسخه‌ی قبلی اجرا می‌شود.
• لاگ زندهلاگ بیلد و زمان اجرا، در CLI و کنسول.
• بازگشت به نسخه‌ی قبلهر استقرار قبلی با یک دستور برمی‌گردد.
• مقیاس‌دهیمنابع و تعداد نمونه‌ها را تغییر دهید یا خودکارش کنید.
• دیسک ماندگاربرای فایل‌هایی که باید بعد از هر استقرار بمانند.
• کران‌جابدستور زمان‌بندی‌شده با همان ایمیج و متغیرها.
• استقرار خودکار با گیتهر push روی شاخه‌ی هدف بیلد و مستقر می‌شود.

خطاهای رایج

web: gunicorn app:app --bind 0.0.0.0:$PORT

sakoocloud apps scale --memory 1Gi

پرسش‌های متداول

جزئیات بیشتر در راهنمای Flask در مستندات و مرجع CLI.