Frameworks giải pháp

Chạy FastAPI trên local với FlyEnv

Ứng dụng FastAPI thường cần một runtime Python cùng với cơ sở dữ liệu và các dịch vụ phụ trợ do API lựa chọn. FlyEnv giúp quản lý các dịch vụ đó xung quanh một dự án FastAPI cục bộ.

Tải xuống FlyEnv Tài liệu chính thức

Stack dự án local

Các dịch vụ FlyEnv có thể quản lý cho FastAPI

Giới thiệu FastAPI

FastAPI là một framework Python để xây dựng các HTTP API có kiểu. Type hint điều khiển validation, serialization, dependency injection và tài liệu OpenAPI, trong khi nền tảng ASGI của nó hỗ trợ endpoint bất đồng bộ và WebSocket.

Một dịch vụ FastAPI local thường chạy qua một ASGI server như Uvicorn. Phần còn lại của môi trường nên đi theo chính dịch vụ đó: một cơ sở dữ liệu có ORM cho dữ liệu lưu trữ lâu dài, migration, cùng các tiến trình worker hoặc broker tùy chọn cho khối lượng công việc bất đồng bộ.

Các khả năng cốt lõi

Validation dựa trên type
Tài liệu OpenAPI
Dependency Injection
Endpoint ASGI bất đồng bộ
WebSocket
Model Pydantic

Các trường hợp sử dụng phổ biến

REST API có kiểu
Dịch vụ backend cho ứng dụng mobile
Endpoint dịch vụ dữ liệu và ML
API tích hợp bất đồng bộ
Nền tảng API nội bộ

Môi trường FastAPI đi theo hợp đồng của dịch vụ

Bản thân framework được thiết kế nhỏ gọn, vì vậy dependency local nên phản ánh cách triển khai API thay vì một stack định sẵn.

Python và ASGI server: Chạy ứng dụng với các Python dependency đã khóa phiên bản và một ASGI server như Uvicorn.
Cơ sở dữ liệu và migration: PostgreSQL hoặc cơ sở dữ liệu khác được chọn đi kèm với ORM và công cụ migration của dự án.
API client và origin bảo mật: Một domain local và HTTPS có thể quan trọng với client trên trình duyệt, redirect OAuth hoặc kiểm thử callback webhook.
Broker và worker khi được thiết kế sẵn: Redis, RabbitMQ hoặc một tiến trình worker chỉ nên có ở nơi API thực sự đẩy công việc nền ra ngoài.

Tài nguyên dự án

Để xem các lệnh cài đặt, phiên bản hỗ trợ và cấu hình riêng của dự án, hãy tham khảo tài liệu chính thức của FastAPI .

Stack local điển hình

Các dịch vụ cụ thể phụ thuộc vào dự án, phiên bản phát hành và cấu hình local của nó. Đây là một thiết lập local phổ biến, không phải yêu cầu cố định.

Thành phần	Vai trò điển hình
Python	Chạy Python cho môi trường local của FastAPI.
PostgreSQL MySQL	Chạy PostgreSQL / MySQL cho môi trường local của FastAPI.
Redis	Chạy Redis cho môi trường local của FastAPI.
Nginx Caddy	Chạy Nginx / Caddy cho môi trường local của FastAPI.

FlyEnv giúp gì

Khớp runtime dự án
Chọn phiên bản runtime mà FastAPI yêu cầu.
Quản lý dịch vụ local
Chỉ khởi động cơ sở dữ liệu, cache và các dịch vụ khác khi dự án cần.
Giữ dự án tách biệt
Để mỗi dự án dùng các phiên bản và cấu hình dịch vụ riêng.
Cấu hình tên miền local
Truy cập dự án qua tên miền local và HTTPS khi cần.

Thiết lập môi trường local

Việc cài đặt dự án vẫn thuộc tài liệu chính thức của dự án. FlyEnv quản lý các runtime, cơ sở dữ liệu, web server và các dịch vụ hỗ trợ xung quanh nó.