هاست Python برای FastAPI و سرویس‌های پایتون

پایتون با هر ابزاری که دارید

سکو کلود ابزار وابستگی را از روی فایل‌های پروژه تشخیص می‌دهد و وابستگی‌ها را از میرور داخلی PyPI نصب می‌کند. نسخه‌ی پایتون از runtime.txt، .python-version یا requires-python خوانده می‌شود.

بهترین راه تعیین دستور اجرا، یک خط web در Procfile است. اگر Procfile نباشد، فایل‌های manage.py، wsgi.py، app.py و main.py به ترتیب بررسی می‌شوند و در صورت نصب بودن، gunicorn یا uvicorn انتخاب می‌شود.

مسیر بیلد Python

1. تشخیص

   یکی از requirements.txt، pyproject.toml، Pipfile، uv.lock یا pdm.lock.

   requirements.txt

2. نسخه

   نسخه‌ی پایتون از runtime.txt یا .python-version تعیین می‌شود.

   python-3.12

3. نصب

   وابستگی‌ها با همان ابزار و از میرور داخلی PyPI نصب می‌شوند.

   pip install -r requirements.txt

4. اجرا

   خط web در Procfile اجرا می‌شود.

   uvicorn main:app

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

$ sakoocloud deploy
✔ Packed 0.3MB
✔ 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-fastapi.sakooapps.ir

FastAPI در کمترین شکل

وب‌سرور باید روی 0.0.0.0 و پورت $PORT گوش بدهد؛ Procfile این را صریح می‌کند.

from fastapi import FastAPI

app = FastAPI()


@app.get("/health")
def health():
    return {"ok": True}

web: uvicorn main:app --host 0.0.0.0 --port $PORT

fastapi==0.115.*
uvicorn[standard]==0.32.*

تنظیمات

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

بعد از لینک کردن دیتابیس، 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 -w 4 -b 0.0.0.0:$PORT app:app

sakoocloud apps scale --memory 1Gi

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

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