How neddy2000/fastapi-idp-lite works
This is a lightweight IDP-style control plane for deploying temporary, isolated static HTML previews. A client submits a project name, HTML, and optional TTL to the FastAPI API; deployment provisions a per-project Nginx container and gateway routing, then returns a preview URL. Clients can list or manually remove projects, while a background cleaner removes expired deployments. The README documents the major runtime capabilities; sampled source confirms request schemas and some handler and cleanup calls, but deployment internals are only partially excerpted.
Main entry points: main.py Deploy Orchestration · sites Site Route Configs · schemas.py Request Schemas · default.conf Gateway Config
Components 16
Control API
- Deploy Endpoint
app/main.py - Project Listing
app/main.py - Undeploy Endpoint
app/main.py - Request Schemas
app/schemas.py
Deployment Lifecycle
- Deploy Orchestration
app/main.py - Site HTML Files
app/main.py - Project Container
- Project Inventory
app/main.py - TTL Cleaner
app/main.py - Site Removal
app/main.py
Preview Serving
- Gateway Config
nginx/default.conf - Site Route Configs
nginx/conf.d/sites - Nginx Gateway
Other components
- API Client
- Docker Engine
- Preview Visitor
Connections 19
- API Client → Deploy Endpoint: submits deployment
README.md - API Client → Project Listing: lists projects
README.md - API Client → Undeploy Endpoint: requests removal
README.md - Deploy Endpoint → Request Schemas: accepts request
app/main.py - Deploy Endpoint → Deploy Orchestration: dispatches to
app/main.py - Deploy Orchestration → Site HTML Files: writes HTML
README.md - Deploy Orchestration → Project Container: starts container
README.md - Deploy Orchestration → Site Route Configs: generates routes
README.md - Deploy Orchestration → Docker Engine: provisions through
README.md - Project Listing → Project Inventory: returns status
README.md - TTL Cleaner → Site Removal: removes expired
app/main.py - Site Removal → Project Container: removes container
README.md - Site Removal → Site Route Configs: removes route
README.md - Site Removal → Docker Engine: cleans up through
README.md - Undeploy Endpoint → Site Removal: dispatches to
app/main.py - Preview Visitor → Nginx Gateway: requests preview
README.md - Nginx Gateway → Gateway Config: uses configuration
- Nginx Gateway → Site Route Configs: routes project paths
README.md - Nginx Gateway → Project Container: serves site from
README.md