带有“--reload”和 Docker 卷的 Hypercorn

我在 Docker 容器中使用 --reload 运行 Hypercorn。我正在运行的文件保存在由 Docker Compose 管理的卷中。

当我更改系统上的文件时,我可以看到更改反映在卷中,例如与 docker compose exec myapp /bin/cat /app/runtime/service.py

但是,当我以这种方式更改文件时,Hypercorn 不会像我预期的那样重新启动。 Hypercorn 和 Docker 卷之间是否存在一些不利的相互作用?还是我期望从 --reload 选项中得到一些我不应该期望的东西?

示例文件如下。我的期望是从容器外部修改 runtime/service.py 会触发 Hypercorn 使用修改后的文件版本重新启动服务器。但这不会发生。

编辑:我应该补充一点,我在 MacOS 10.14.6 上通过 Docker Desktop for Mac 使用 Docker 20.10.5。

编辑 2:这可能是 Hypercorn 错误。如果我在 uvicorn[standard] 中添加 requirements.txt 并运行 python -m uvicorn --reload --host 0.0.0.0 --port 8001 service:app ,则重新加载工作正常。可能相关: https://gitlab.com/pgjones/hypercorn/-/issues/185

entrypoint.sh

#!/bin/sh
cd /app/runtime
/opt/venv/bin/python -m hypercorn --reload --bind 0.0.0.0:8001 service:app

Dockerfile

FROM $REDACTED

RUN /opt/venv/bin/python -m pip install -U pip
RUN /opt/venv/bin/pip install -U setuptools wheel

COPY requirements.txt /app/requirements.txt
RUN /opt/venv/bin/pip install -r /app/requirements.txt

COPY requirements-dev.txt /app/requirements-dev.txt
RUN /opt/venv/bin/pip install -r /app/requirements-dev.txt

COPY entrypoint.sh /app/entrypoint.sh

EXPOSE 8001/tcp

CMD ["/app/entrypoint.sh"]

docker-compose.yml

version: "3.8"
services:
  api:
    container_name: api
    hostname: myapp
    build:
      context: .
    ports:
      - 8001:8001
    volumes:
      - ./runtime:/app/runtime

runtime/service.py

import logging
import quart

logger = logging.getLogger(__name__)
logging.basicConfig(level=logging.INFO)

app = quart.Quart(__name__)

@app.route('/')
async def handle_hello():
    logger.info('Handling request.')
    return 'Hello, world!n'

@app.route('/bad')
async def handle_bad():
    logger.critical('Bad request.........')
    raise RuntimeError('Oh no!!!')
stack overflow Hypercorn with "--reload" and Docker volumes
原文答案

答案:

作者头像

这是一个使用 does 自动重新加载 hypercorn 的最小的、完全工作的示例:

docker-compose.yaml

services:
  app:
    build: .
    # Here --reload is used which works as intended!
    command: hypercorn --bind 0.0.0.0:8080 --reload src:app
    ports:
      - 8080:8080
    volumes:
      - ./src:/app/src

Dockerfile

FROM python:3.10-slim-bullseye
WORKDIR /app                                                          
RUN pip install hypercorn==0.14.3 quart==0.18.0
COPY src ./src
EXPOSE 8080
ENV QUART_APP=src:app
# This is the production command; docker-compose.yaml overwrites it for local development
CMD hypercorn --bind 0.0.0.0:8080 src:app

src/__init__.py

from quart import Quart

app=Quart(__name__)

@app.route('/', methods=['GET'])
def get_root():
    return "Hello world!"

通过 docker-compose up 运行并注意 hypercorn__init__.py 被修改后如何重新加载。

作者头像

您可能需要使用 volume mount 来获得重新加载功能!

这是因为当您构建容器时,它会将您在本地拥有的任何东西烘焙到其中。进一步的更改只会影响您的本地文件系统。


可以说这不是预期用途(因为容器变得依赖于外部文件!),但可能对更快的测试/调试有用

您也可以通过连接到它来直接编辑容器,您可能会发现它适合您的需求。