当前位置: 首页 > news >正文

学有所记- 探索FastAPI在docker上的部署

目标:

学习怎样在docker中安装部署FastAPI,完成项目结构的搭建以及hello world的运行

 

背景:

公司内服务器资源有限,为了共享算力资源,同时又能隔离运行环境,因此采用了docker部署的方式,进行各种开发测试。网上虽然已有集成fastapi+uvicorn+gunicorn,自己动手,可以了解更多细节,以及更深度的定制,从而学习怎样自定义镜像文件以及启动docker。

 

实现过程:

1、安装docker(系统已默认安装,可参照网上教程,以后另外再补记)

2、安装python。选用了3.11版

3、安装pycharm 社区版。

4、建立项目文件夹

project:my_fastapi

====app (目录)

     ----main.py

     ----requirements.txt

====docker (目录)

    ----Dockerfile

    ----docker-compose.yaml

5、编辑 main.py

import os
import sys
from multiprocessing import freeze_support

import uvicorn
from fastapi import FastAPI, UploadFile, File
from fastapi.middleware.cors import CORSMiddleware
from contextlib import asynccontextmanager

upload_files_save_path = os.environ["UPLOAD_FILE"] if "UPLOAD_FILE" in os.environ else "/upload"

@asynccontextmanager
async def lifespan(app: FastAPI):
    # 初始化阶段
    print('初始化成功..')
    yield
    # 清理阶段
    print('卸载成功..')


app = FastAPI(root_path="/aiCentre"
              , lifespan=lifespan
              )  # aicentre为nginx中api路由名
# 启用CORS支持
app.add_middleware(
    CORSMiddleware,
    allow_origins=["*"],
    allow_credentials=True,
    allow_methods=["*"],  # 或者只列出 ["POST", "GET", "OPTIONS", ...] 等
    allow_headers=["*"],
)


# 路由
@app.get("/")
async def read_root():
    return {"message": "Hello World!"}

@app.post("/uploadfile/")
async def create_upload_file(file: UploadFile = File(...)):
    file_location = f"files/{file.filename}"
    with open(file_location, "wb+") as file_object:
        file_object.write(await file.read())
    return {"info": f"file '{file.filename}' saved at '{file_location}'",}


if __name__ == "__main__":
    freeze_support()

    uvicorn.run('main:app', host="0.0.0.0", port=8080, reload=True, workers=1)
    #current_dir = os.path.dirname(os.path.realpath(__file__))
    # 将项目根目录添加到 Python 路径中
    #sys.path.append(current_dir)
    # print(upload_files_save_path)

6、用pip freeze命令生成python库文件列表,用于移植。

 pip freeze > requirements.txt
annotated-types==0.7.0
anyio==4.9.0
click==8.1.8
colorama==0.4.6
fastapi==0.115.12
h11==0.14.0
idna==3.10
pydantic==2.11.1
pydantic_core==2.33.0
python-multipart==0.0.20
sniffio==1.3.1
starlette==0.46.1
typing-inspection==0.4.0
typing_extensions==4.13.0
uvicorn==0.34.0

7、编写 Dockerfile

# 建立 python3.11 环境
# FROM python:3.11

FROM docker.1ms.run/python:3.11

# 设置pip源为国内源
# COPY pip.conf /root/.pip/pip.conf
 
# 镜像作者云无碍
LABEL maintainer="yunwuai <xxx@yyyy.zzzzz>"

# 在容器内/var/www/html/下创建 mysite1文件夹
# RUN mkdir -p /var/www/html/mysite1
# 将当前目录文件加入到容器工作目录中(. 表示当前宿主机目录)
# ADD . /var/www/html/mysite1
RUN mkdir -p /app
RUN mkdir -p /upload

COPY . /app
# 设置容器内工作目录
WORKDIR /app
# RUN echo $PWD
# 利用 pip 安装依赖
# 设置安装依赖包的镜像以及安装相关的依赖包,需要安装的依赖包以及版本提前在requirements.txt文件里写出来
RUN pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
RUN pip install -r /app/requirements.txt
# RUN pip3 install pandas numpy moviepy pydub matplotlib python-multipart uvicorn

# 设置 python 环境变量
ENV PYTHON_ENV_TEST=/app

# Run the start script, it will check for an /app/prestart.sh script (e.g. for migrations)
# And then will start Gunicorn with Uvicorn
# 声明运行时的端口
EXPOSE 8080

# 运行Gunicorn服务器
# docker  build  -t  my_fastapi  .
CMD ["python","/app/main.py"]


  在app目录下运行

docker  build  -t my_fastapi:test -f ..\docker\Dockerfile . 

(最后有一个“.”号,这个很重要,代表当前目录,小白复制网上的代码时,很容易遗漏)

 或在项目目录下运行:

docker  build  -t my_fastapi:test -f docker\Dockerfile app

 

8、编写docker-compose.yaml

services:
  fastapi:
    image: my_fastapi:test
    ports:
      - 8181:8080
    environment:
      ENV_PARAMS: test_param
      MODEL_NAME: fastmodel

启动docker

docker-compose.exe -f docker\docker-compose.yaml up -d 

 

总结:

1、docker 运行时的端口镜像,前后顺序不要写错 是先宿主机再容器 即 -p 宿主机端口:容器内端口

2、docker build 时,最后一个参数为dockerfile中的“当前目录”,当出现文件无法复制或找不到文件时,一般都是当前路径设置有误.

3,启动docker-compose报错,很多时候是因为参数顺序搞错,把up -d放到 -f前面去了。up -d 一般在命令最后

4、fastAPI自带swagger功能,可以通过 http://127.0.0.1:8181/docs 和 http://127.0.0.1:8181/redoc进行访问和测试

 

 

 

 

 

相关文章:

  • vLLM 部署 openai whisper 模型实现语音转文字
  • C语言基础:弟11天笔记
  • ubuntu20.04 APT 安装MySQL Community Server 8
  • vue create 与 vue init webpack 的 区别
  • 游戏搭建云服务器配置推荐
  • PyTorch --torch.cat张量拼接原理
  • 前端er在Cursor使用MCP实现精选照片的快速上手教程
  • AISTATS 2025 | ChronosX:利用外生变量调整预训练时间序列模型
  • Fnos 飞牛Nas安装桌面环境 gnome和KDE桌面- All in One 笔记~1
  • Dubbo(25)如何配置Dubbo的协议和端口?
  • 【减小图片打包体积】image-webpack-loader
  • MySQL--数据备份
  • 实时数据流处理利器:Apache Storm 在大数据中的应用
  • .Net中对称加密的实现
  • cJSON类型及type值详解
  • ECharts系列: Vue 中使用 ECharts 折线图时,怎么配置来实现默认隐藏某些图例,并在用户点击图例时显示或隐藏对应的数据系列
  • MySQL的事务
  • Springboot3.x集成Spring Batch 5.2.1
  • 面试经典150题·LeetCode26·删除有序数组中的重复项·Java
  • 18.redis基本操作
  • 做网站要学哪些程序/seo是哪个英文的简写
  • 加强网站建设说明报告范文/地推网app推广平台
  • 用自己电脑做网站空间/搜索关键词排名优化
  • 网站建设网络推广加盟/外贸网站都有哪些
  • 域名申请通过了网站怎么做/百度刷排名seo
  • 一般找素材都是做哪几个网站呢/企业seo网站推广