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阅读 203,772评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,458评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,610评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,640评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,657评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,590评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,962评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,631评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,870评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,611评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,704评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,386评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,969评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,944评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,179评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,742评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,440评论 2 342

推荐阅读更多精彩内容

  • 第二节.docker镜像管理 介绍docker镜像是一个不包含Linux内核的操作系统[root@data doc...
    小短腿电工阅读 1,925评论 0 2
  • 首先废话一下,FastAPI是一种现代,快速(高性能)的Web框架,用于基于标准Python类型提示使用Pytho...
    甲乙寄几阅读 4,829评论 0 3
  • https://hijiangtao.github.io/2018/04/17/Docker-in-Action/...
    旭娃阅读 2,609评论 2 14
  • 久违的晴天,家长会。 家长大会开好到教室时,离放学已经没多少时间了。班主任说已经安排了三个家长分享经验。 放学铃声...
    飘雪儿5阅读 7,475评论 16 22
  • 创业是很多人的梦想,多少人为了理想和不甘选择了创业来实现自我价值,我就是其中一个。 创业后,我由女人变成了超人,什...
    亦宝宝阅读 1,801评论 4 1