rust的学习笔记

电气化、自动化、数字化、智能化、智慧化

0%

用Docker打包FastAPI程序

简介

这一篇看看如何将使用FastAPI编写的程序打包成docker镜像。
参考教程见这里

安装依赖包

一般是使用requirements.txt来管理所依赖的包的名字及版本。
该文件的内容形如:

1
2
3
fastapi>=0.68.0,<0.69.0
pydantic>=1.8.0,<2.0.0
uvicorn>=0.15.0,<0.16.0

可以在程序编写过程中手动指定以上内容。
也可以在代码完成后,使用如下命令自动生成:
1
pip freeze > requirements.txt

有了上述requirements.txt文件后,则可以进行安装:
1
pip install -r requirements.txt

创建FastAPI项目

(1)创建app文件夹,然后进入该目录;
(2)创建一个空的文件__init__.py
(3)创建main.py,内容为:

1
2
3
4
5
6
7
8
9
10
11
12
from typing import Union
from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
return {"Hello": "World"}

@app.get("/items/{item_id}")
def read_item(item_id: int, q: Union[str, None] = None):
return {"item_id": item_id, "q": q}

创建Dockerfile文件

在当前目录下,创建Dockerfile文件,内容为:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# 指定基础镜像
FROM python:3.9

# 指定镜像内的工作目录
WORKDIR /code

# 从本地源路径中复制requirements文件到目标路径中,注意这里仅复制了这个文件,是为了使得接着构建的镜像能够利用缓存;因为依赖包通常不频繁发生改动,所以先把它构建了。
COPY ./requirements.txt /code/requirements.txt

# 执行命令,这里是安装依赖包。
RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt

# 再复制其余的源文件,这些源文件因为是业务逻辑,所以变动的可能性很大,放在最上面构建,而不是放在最开头构建,能够有效地避免这一部分带来的变化,从而利用缓存,节省构建时间。
COPY ./app /code/app

# 容器启动命令
CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]

关于Dockerfile编写的详细教程,可以参考该教程

构建Docker镜像

当前目录的文件结构如下:

1
2
3
4
5
6
.
├── app
│ ├── __init__.py
│ └── main.py
├── Dockerfile
└── requirements.txt

在该目录下执行:
1
docker build -t myimage .

启动Docker容器

1
docker run -d --name mycontainer -p 80:80 myimage

测试访问

访问http://127.0.0.1/items/5?q=somequery(或者使用具体的IP地址),则能正确返回结果。
交互式文档http://127.0.0.1/docshttp://127.0.0.1/redoc也能正常访问。

分享镜像

搭建好镜像后,可以通过以下几种方式分享:
(1)上传到docker hub中央库或私有中央库;
(2)传输最原始的文件结构,由对方自己build,这种是最轻便的;
(3)通过docker savetar包,可以适用于对方无法联网的情形。