FastAPI部署-docker篇

    FastAPI是一种现代，快速（高性能）的Web框架，用于基于标准Python类型提示使用Python 3.6+构建API,对飚go和nodejs。

 FastAPI github地址：https://github.com/tiangolo/fastapi

Uvicorn

Uvicorn是一款闪电般的“ ASGI”服务器。

它在单个过程中运行异步Python Web代码。

Gunicorn

您可以使用Gunicorn管理Uvicorn和运行多个这些并发进程。

这样，您将获得最佳的并发性和并行性。

FastAPI

FastAPI是一种现代，快速（高性能）的Web框架，用于使用Python 3.6+构建API。

步骤一：创建dockfile

#Dockerfile

FROM tiangolo/uvicorn-gunicorn-fastapi:python3.7

COPY ./app /app

dockerfile的意思就是把当前目录（./app）复制到 /app文件夹中。

步骤二：创建FastAPI文件

mkdir app

vim main.py

main.py文件内容如下：

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: str = None):

       return {"item_id": item_id, "q": q}

目录结构如下：

├── app

│   └── main.py

└── Dockerfile

步骤三：创建镜像

docker build -t fastapi_image ./

Sending build context to Docker daemon 3.584kB

Step 1/2 : FROM tiangolo/uvicorn-gunicorn-fastapi:python3.7

---> 23579a0a7c50

Step 2/2 : COPY ./app /app

---> Using cache

---> 8c41afea5ee1

Successfully built 8c41afea5ee1

Successfully tagged fastapi_image:latest

查看创建的image

docker image ls|grep fastapi_image

步骤四：启动应用

docker run -d --name fastapi_container -p 10001:80 fastapi_image

15984271b4792db1025224da534be5951307b8433dc8e41babbcba073a2baa24

查看刚才启动的应用

docker container ls |grep fastapi

15984271b479 fastapi_image "/start.sh" About a minute ago Up About a minute 0.0.0.0:10001->80/tcp fastapi_container

步骤五：访问应用

通过浏览器  http://ip地址:10001

或者命令行：curl http://127.0.0.1:10001

{"Hello":"World"}

http://127.0.0.1/docs   #API文档

http://127.0.0.1/redoc  #备用API文档


下面我们来分析下镜像的构建过程：

docker image ls |grep fastapi

docker history fastapi_image:latest

[root@kube-test-master ~]# docker history fastapi_image:latest

IMAGE              CREATED            CREATED BY                                      SIZE                COMMENT

8c41afea5ee1        2 days ago          /bin/sh -c #(nop) COPY dir:d1727655ba287a3f2…  223B               

23579a0a7c50        5 weeks ago        /bin/sh -c #(nop) COPY dir:81482727cef4cc213…  292B               

<missing>          5 weeks ago        /bin/sh -c pip install --no-cache-dir fastapi  25.4MB             

<missing>          5 weeks ago        /bin/sh -c #(nop)  LABEL maintainer=Sebastia…  0B                 

<missing>          5 weeks ago        /bin/sh -c #(nop)  CMD ["/start.sh"]            0B                 

<missing>          5 weeks ago        /bin/sh -c #(nop)  EXPOSE 80                    0B                 

<missing>          5 weeks ago        /bin/sh -c #(nop)  ENV PYTHONPATH=/app          0B                 

<missing>          5 weeks ago        /bin/sh -c #(nop) WORKDIR /app/                0B                 

<missing>          5 weeks ago        /bin/sh -c #(nop) COPY dir:2e485a98ab454814a…  844B               

<missing>          5 weeks ago        /bin/sh -c chmod +x /start-reload.sh            848B               

<missing>          5 weeks ago        /bin/sh -c #(nop) COPY file:1ee462cef5d29106…  848B               

<missing>          5 weeks ago        /bin/sh -c #(nop) COPY file:64f25d957a18eec5…  1.94kB             

<missing>          5 weeks ago        /bin/sh -c chmod +x /start.sh                  1.11kB             

<missing>          5 weeks ago        /bin/sh -c #(nop) COPY file:46531dace36927e7…  1.11kB             

<missing>          5 weeks ago        /bin/sh -c pip install --no-cache-dir uvicor…  25.5MB             

<missing>          5 weeks ago        /bin/sh -c #(nop)  LABEL maintainer=Sebastia…  0B                 

<missing>          6 weeks ago        /bin/sh -c #(nop)  CMD ["python3"]              0B                 

<missing>          6 weeks ago        /bin/sh -c set -ex;  wget -O get-pip.py "$P…  6.34MB             

<missing>          6 weeks ago        /bin/sh -c #(nop)  ENV PYTHON_GET_PIP_SHA256…  0B                 

<missing>          6 weeks ago        /bin/sh -c #(nop)  ENV PYTHON_GET_PIP_URL=ht…  0B                 

<missing>          6 weeks ago        /bin/sh -c #(nop)  ENV PYTHON_PIP_VERSION=20…  0B                 

<missing>          6 weeks ago        /bin/sh -c cd /usr/local/bin  && ln -s idle3…  32B               

<missing>          6 weeks ago        /bin/sh -c set -ex  && wget -O python.tar.x…  91MB               

<missing>          6 weeks ago        /bin/sh -c #(nop)  ENV PYTHON_VERSION=3.7.7    0B                 

<missing>          6 weeks ago        /bin/sh -c #(nop)  ENV GPG_KEY=0D96DF4D4110E…  0B                 

<missing>          6 weeks ago        /bin/sh -c apt-get update && apt-get install…  17.9MB             

<missing>          6 weeks ago        /bin/sh -c #(nop)  ENV LANG=C.UTF-8            0B                 

<missing>          6 weeks ago        /bin/sh -c #(nop)  ENV PATH=/usr/local/bin:/…  0B                 

<missing>          6 weeks ago        /bin/sh -c set -ex;  apt-get update;  DEBIAN…  510MB             

<missing>          6 weeks ago        /bin/sh -c apt-get update && apt-get install…  146MB             

<missing>          6 weeks ago        /bin/sh -c set -ex;  if ! command -v gpg > /…  17.5MB             

<missing>          6 weeks ago        /bin/sh -c apt-get update && apt-get install…  16.5MB             

<missing>          6 weeks ago        /bin/sh -c #(nop)  CMD ["bash"]                0B                 

<missing>          6 weeks ago        /bin/sh -c #(nop) ADD file:f086177965196842a…  114MB   

由以上信息可以知道workdir 是/app,应用启动脚本start.sh，重启脚本start-reload.sh

进入容器进一步验证

docker container ls |grep fastapi

15984271b479 fastapi_image "/start.sh" 34 minutes ago Up 34 minutes 0.0.0.0:10001->80/tcp fastapi_container

docker exec -it 15984271b479 /bin/bash

root@15984271b479:/app# ls

__pycache__  main.py  prestart.sh

root@15984271b479:/app# cd ..

root@15984271b479:/# ls

app  boot  etc              home  lib64  mnt  proc  run  srv              start.sh  tmp  var

bin  dev  gunicorn_conf.py  lib  media  opt  root  sbin  start-reload.sh  sys      usr

root@15984271b479:/#

start.sh  start-reload.sh位于根目录

root@15984271b479:/# cat start.sh

#! /usr/bin/env sh

set -e

if [ -f /app/app/main.py ]; then

    DEFAULT_MODULE_NAME=app.main

elif [ -f /app/main.py ]; then

    DEFAULT_MODULE_NAME=main

fi

MODULE_NAME=${MODULE_NAME:-$DEFAULT_MODULE_NAME}

VARIABLE_NAME=${VARIABLE_NAME:-app}

export APP_MODULE=${APP_MODULE:-"$MODULE_NAME:$VARIABLE_NAME"}

if [ -f /app/gunicorn_conf.py ]; then

    DEFAULT_GUNICORN_CONF=/app/gunicorn_conf.py

elif [ -f /app/app/gunicorn_conf.py ]; then

    DEFAULT_GUNICORN_CONF=/app/app/gunicorn_conf.py

else

    DEFAULT_GUNICORN_CONF=/gunicorn_conf.py

fi

export GUNICORN_CONF=${GUNICORN_CONF:-$DEFAULT_GUNICORN_CONF}

export WORKER_CLASS=${WORKER_CLASS:-"uvicorn.workers.UvicornWorker"}

# If there's a prestart.sh script in the /app directory or other path specified, run it before starting

PRE_START_PATH=${PRE_START_PATH:-/app/prestart.sh}

echo "Checking for script in $PRE_START_PATH"

if [ -f $PRE_START_PATH ] ; then

    echo "Running script $PRE_START_PATH"

    . "$PRE_START_PATH"

else

    echo "There is no script $PRE_START_PATH"

fi

# Start Gunicorn

exec gunicorn -k "$WORKER_CLASS" -c "$GUNICORN_CONF" "$APP_MODULE"


gunicorn_conf.py

root@15984271b479:/# cat gunicorn_conf.py

import json

import multiprocessing

import os

workers_per_core_str = os.getenv("WORKERS_PER_CORE", "1")

max_workers_str = os.getenv("MAX_WORKERS")

use_max_workers = None

if max_workers_str:

    use_max_workers = int(max_workers_str)

web_concurrency_str = os.getenv("WEB_CONCURRENCY", None)

host = os.getenv("HOST", "0.0.0.0")

port = os.getenv("PORT", "80")

bind_env = os.getenv("BIND", None)

use_loglevel = os.getenv("LOG_LEVEL", "info")

if bind_env:

    use_bind = bind_env

else:

    use_bind = f"{host}:{port}"

cores = multiprocessing.cpu_count()

workers_per_core = float(workers_per_core_str)

default_web_concurrency = workers_per_core * cores

if web_concurrency_str:

    web_concurrency = int(web_concurrency_str)

    assert web_concurrency > 0

else:

    web_concurrency = max(int(default_web_concurrency), 2)

    if use_max_workers:

        web_concurrency = min(web_concurrency, use_max_workers)

accesslog_var = os.getenv("ACCESS_LOG", "-")

use_accesslog = accesslog_var or None

errorlog_var = os.getenv("ERROR_LOG", "-")

use_errorlog = errorlog_var or None

graceful_timeout_str = os.getenv("GRACEFUL_TIMEOUT", "120")

timeout_str = os.getenv("TIMEOUT", "120")

keepalive_str = os.getenv("KEEP_ALIVE", "5")

# Gunicorn config variables

loglevel = use_loglevel

workers = web_concurrency

bind = use_bind

errorlog = use_errorlog

worker_tmp_dir = "/dev/shm"

accesslog = use_accesslog

graceful_timeout = int(graceful_timeout_str)

timeout = int(timeout_str)

keepalive = int(keepalive_str)

# For debugging and testing

log_data = {

    "loglevel": loglevel,

    "workers": workers,

    "bind": bind,

    "graceful_timeout": graceful_timeout,

    "timeout": timeout,

    "keepalive": keepalive,

    "errorlog": errorlog,

    "accesslog": accesslog,

    # Additional, non-gunicorn variables

    "workers_per_core": workers_per_core,

    "use_max_workers": use_max_workers,

    "host": host,

    "port": port,

}

print(json.dumps(log_data))

其中有两个变量 ACCESS_LOG  ERROR_LOG是日志输出的路径，如果没定义默认不输出日志。

如果是正式环境，建议设置路径。具体见官方文档，并使用 -v参数映射到宿主机目录。

docker container logs fastapi_container  查看容器logs

docker container inspect fastapi_container 

可以获取容器的详细信息

其中id 15984271b4792db1025224da534be5951307b8433dc8e41babbcba073a2baa24

存放路径位置

/var/lib/docker/containers/15984271b4792db1025224da534be5951307b8433dc8e41babbcba073a2baa24

{"log":"{\"loglevel\": \"info\", \"workers\": 2, \"bind\": \"0.0.0.0:80\", \"graceful_timeout\": 120, \"timeout\": 120, \"keepa

live\": 5, \"errorlog\": \"-\", \"accesslog\": \"-\", \"workers_per_core\": 1.0, \"use_max_workers\": null, \"host\": \"0.0.0.0

\", \"port\": \"80\"}\n","stream":"stdout","time":"2020-06-08T01:58:54.535459288Z"}

{"log":"192.168.101.202:62512 - \"GET / HTTP/1.1\" 200\n","stream":"stdout","time":"2020-06-08T01:58:54.535495087Z"}

{"log":"192.168.101.202:62512 - \"GET /favicon.ico HTTP/1.1\" 404\n","stream":"stdout","time":"2020-06-08T01:58:55.271215897Z"}

{"log":"172.17.0.1:41038 - \"GET / HTTP/1.1\" 200\n","stream":"stdout","time":"2020-06-08T02:00:02.409539216Z"}

{"log":"{\"loglevel\": \"info\", \"workers\": 2, \"bind\": \"0.0.0.0:80\", \"graceful_timeout\": 120, \"timeout\": 120, \"keepa

live\": 5, \"errorlog\": \"-\", \"accesslog\": \"-\", \"workers_per_core\": 1.0, \"use_max_workers\": null, \"host\": \"0.0.0.0

\", \"port\": \"80\"}\n","stream":"stdout","time":"2020-06-08T02:00:07.276382848Z"}

{"log":"172.17.0.1:41074 - \"GET / HTTP/1.1\" 200\n","stream":"stdout","time":"2020-06-08T02:00:07.276421756Z"}

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 159,290评论 4赞 363
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 67,399评论 1赞 294
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 109,021评论 0赞 243
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 44,034评论 0赞 207
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 52,412评论 3赞 287
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 40,651评论 1赞 219
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 31,902评论 2赞 313
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 30,605评论 0赞 199
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 34,339评论 1赞 246
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,586评论 2赞 246
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,076评论 1赞 261
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 28,400评论 2赞 253
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 33,060评论 3赞 236
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,083评论 0赞 8
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,851评论 0赞 195
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 35,685评论 2赞 274
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 35,595评论 2赞 270

推荐阅读更多精彩内容