Docker部署FastApi详解，这一篇就够了_uvicorn fastapi用于生产

#Dockerfile
 
FROM tiangolo/uvicorn-gunicorn-fastapi:python3.7
 
COPY ./app /app

#这个其实就是镜像中自带的main.py 位置/app/main.py
import sys
 
from fastapi import FastAPI
 
version = f"{sys.version_info.major}.{sys.version_info.minor}"
 
app = FastAPI()
 
 
@app.get("/")
async def read_root():
    message = f"Hello world! From FastAPI running on Uvicorn with Gunicorn. Using Python {version}"
    return {"message": message}

.
├── app
│   └── main.py
└── Dockerfile

# 在dockerfile的路径下执行 myimage 替换成自己的起的名字作为镜像名
docker build -t myimage ./  

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

docker pull tiangolo/uvicorn-gunicorn-fastapi:python3.7
 
docker run -d --name fastapidemo -p 80:80 tiangolo/uvicorn-gunicorn-fastapi:python3.7

http://127.0.0.1/   
#返回{"message":"Hello world! From FastAPI running on Uvicorn with Gunicorn. Using Python 3.7"}
 
http://127.0.0.1/docs
#API文档 
 
http://127.0.0.1/redoc
# 备用API文档

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

FROM tiangolo/uvicorn-gunicorn-fastapi:python3.7
 
# Install Poetry
RUN curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | POETRY_HOME=/opt/poetry python && \
    cd /usr/local/bin && \
    ln -s /opt/poetry/bin/poetry && \
    poetry config virtualenvs.create false
 
# Copy using poetry.lock* in case it doesn't exist yet
COPY ./app/pyproject.toml ./app/poetry.lock* /app/
RUN poetry install --no-root --no-dev
COPY ./app /app

# DockerFile tiangolo/uvicorn-gunicorn-fastapi:python3.7
FROM python:3.7
 
LABEL maintainer="Sebastian Ramirez <tiangolo@gmail.com>"
 
RUN pip install --no-cache-dir uvicorn gunicorn
 
COPY ./start.sh /start.sh
RUN chmod +x /start.sh
 
COPY ./gunicorn_conf.py /gunicorn_conf.py
 
COPY ./start-reload.sh /start-reload.sh
RUN chmod +x /start-reload.sh
 
COPY ./app /app
WORKDIR /app/
 
ENV PYTHONPATH=/app
 
EXPOSE 80
 
# Run the start script, it will check for an /app/prestart.sh script (e.g. for migrations)
# And then will start Gunicorn with Uvicorn
CMD ["/start.sh"]

docker run -d -p 80:80 -e MODULE_NAME="custom_app.custom_main" myimage

from fastapi import FastAPI
 
api = FastAPI()
 
 
@api.get("/")
def read_root():
    return {"Hello": "World"}

docker run -d -p 80:80 -e VARIABLE_NAME="api" myimage
# 运行时修改VARIABLE_NAME

docker run -d -p 80:80 -e APP_MODULE="custom_app.custom_main:api" myimage

docker run -d -p 80:80 -e GUNICORN_CONF="/app/custom_gunicorn_conf.py" myimage

docker run -d -p 80:8080 -e LOG_LEVEL="warning" myimage

docker run -d -p 80:8080 -e TIMEOUT="20" myimage

docker run -d -p 80:8080 -e GRACEFUL_TIMEOUT="20" myimage

docker run -d -p 80:8080 -e KEEP_ALIVE="20" myimage

docker run -d -p 80：8080 -e ERROR_LOG = myimage

docker run -d -p 80：8080 -e GUNICORN_CMD_ARGS = “” --keyfile = / secrets / key.pem --certfile = / secrets / cert.pem “ -e PORT = 443

• /app/gunicorn_conf.py
• /app/app/gunicorn_conf.py
• /gunicorn_conf.py

当然，环境变量也不是必须在启动时从docker run 后面指定，使用dockerfile的ENV设置能获得更好的体验

其他功能 ：开发时重载

基于 ： /start-reload.sh

docker run -d -p 80:80 -v $(pwd):/app myimage /start-reload.sh

# /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"

# /start-reload.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"}
 
HOST=${HOST:-0.0.0.0}
PORT=${PORT:-80}
LOG_LEVEL=${LOG_LEVEL:-info}
 
# 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 Uvicorn with live reload
exec uvicorn --reload --host $HOST --port $PORT --log-level $LOG_LEVEL "$APP_MODULE"