tiangolo/uvicorn-gunicorn-fastapi-docker
Uvicorn Gunicorn Fastapi Docker
This project is a production-ready Docker deployment template for FastAPI applications. It provides a standardized Python web application container that integrates Uvicorn as the ASGI server and Gunicorn as the process manager to handle concurrent requests across multiple CPU cores.
The configuration enables performance tuning by adjusting worker processes and server settings based on available CPU resources. It utilizes a multi-stage Docker build to separate build dependencies from the final runtime image.
The system covers containerized web hosting, including support for environment-variable configuration and the execution of pre-start scripts for tasks such as database migrations. It also includes functionality for development live reloading to restart the server automatically when code changes are detected.
Features
- Containerized Application Deployments - Provides a standardized production-ready containerized deployment for FastAPI applications.
- ASGI Servers - Configures Uvicorn as a high-performance ASGI server to serve asynchronous Python web applications.
- Application Runtime Containers - Ships a standardized Python web application container image for consistent environment and dependency management.
- Multi-Stage Container Builds - Utilizes multi-stage Docker builds to separate build dependencies from the final runtime image for reduced size and security.
- Container Image Layering - Provides a layered container architecture to ensure consistent application behavior across different hosting environments.
- Docker Container Deployments - Provides a production-ready Docker template that packages FastAPI applications and dependencies into optimized images.
- Production Deployment Tools - Provides production-grade deployment patterns using Gunicorn and Uvicorn for scalable FastAPI execution.
- Gunicorn Worker Configurations - Integrates Gunicorn as a process manager to handle concurrent requests across multiple CPU cores via worker pools.
- ASGI-Based - Implements an ASGI-based server gateway to handle concurrent web requests via a non-blocking event loop.
- Web Server Hosting - Provides a standardized Docker-based hosting environment for deploying Python web applications across diverse servers.
- Container Environment Initialization - Automates container environment initialization including database migrations and setup scripts during boot.
- Server Configuration Management - Provides utilities for tuning server parameters and worker behavior based on available CPU resources.
- Web Server Tuning - Optimizes web server performance by tuning worker processes and server settings based on CPU resources.
- Startup Hooks - Ships a mechanism to execute custom shell scripts for database migrations and environment setup before application startup.
- Environment Variable-Based Configuration - Implements application configuration driven by environment variables for runtime server behavior and worker counts.
- Container Images - High-performance image using Gunicorn and Uvicorn workers.
