itaru2622/fastapi

镜像概述

itaru2622/fastapi:bookworm是一个用于快速部署FastAPI应用的Docker镜像，基于Debian bookworm系统，提供灵活的配置选项，支持自定义依赖安装、应用入口及启动参数，简化FastAPI应用的容器化部署流程。

核心功能和特性

• 灵活的依赖管理：支持通过环境变量指定apt和pip依赖文件路径，自动安装系统依赖和Python依赖
• 自定义uvicorn配置：通过环境变量设置uvicorn启动参数（如主机、端口、热重载等）
• 应用入口定制：可通过环境变量指定FastAPI应用入口（如main:app）
• 自定义启动脚本：支持使用用户提供的start.sh（当前目录或bin/目录下的可执行脚本）完全控制启动流程

使用场景

• 快速部署FastAPI应用原型或生产环境服务
• 需要动态调整依赖和启动参数的开发环境
• 希望简化FastAPI容器化配置的场景

使用方法和配置说明

简单用法（Linux）

通过挂载当前目录到容器的/app目录，自动安装依赖并启动应用：

bash
docker run --rm -it -p 8000:8000 -v ${PWD}:/app itaru2622/fastapi:bookworm

上述命令执行以下操作：

1. 安装/app/requirements-apt.txt中指定的系统依赖
2. 安装/app/requirements.txt中指定的Python依赖
3. 启动uvicorn服务，入口为main:app

高级用法（Linux）

通过环境变量自定义配置，例如指定依赖文件路径、应用入口和uvicorn参数：

bash
docker run --rm -it -p 8000:8000 -v ${PWD}:${PWD} -w ${PWD} \
  -e py_requirements=${PWD}/requirements.txt \
  -e apt_requirements=${PWD}/requirements-apt.txt \
  -e app=main:app \
  -e opts='--host 0.0.0.0 --reload --reload-include "*.py" --reload-include "*.conf"' \
  itaru2622/fastapi:bookworm

上述命令执行以下操作：

1. 安装${apt_requirements}中指定的系统依赖
2. 安装${py_requirements}中指定的Python依赖
3. 使用${opts}参数启动uvicorn，应用入口为${app}

自定义启动脚本

若当前目录或bin/目录下存在可执行的start.sh，容器将优先执行该脚本以完全控制启动流程。

环境变量配置